Realtime Compute for Apache Flink:Extensión de VS Code para desarrollo local

Paso 1: Crear un trabajo

• Método 1: En el panel de navegación izquierdo, haga clic en el icono . En la sección QUICK START, haga clic en Create a new deployment. Introduzca un nombre en la parte superior y presione Enter para crear un archivo con la extensión .vvp. La extensión genera un trabajo con campos predeterminados.

• Método 2: Cree un nuevo archivo con la extensión .vvp directamente en el explorador de archivos. La extensión rellena el archivo con una configuración de trabajo predeterminada.

Paso 2: Configurar el trabajo

Los parámetros se pueden configurar directamente en el formulario de la interfaz de usuario.

Si está familiarizado con la configuración de trabajos, haga clic en Raw File en la esquina superior izquierda para configurar el trabajo en el archivo fuente. Al hacer clic en el nombre de un parámetro en el formulario de la interfaz, se navega a su definición en el archivo fuente.

{
  "name": "test",
  "artifact": {
    "kind": "SQLSCRIPT",
    "sqlArtifact": {
      "additionalDependencies": [],
      "sqlScript": ""
    }
  },
  "deploymentTarget": {
    "mode": "PER_JOB",
    "name": "default-queue"
  },
  ...
}

• Basic: Configure los parámetros básicos.

  Trabajo SQL

  Parámetro	Descripción
  Deployment Name	El nombre del despliegue.
  Execution Mode	El modo de despliegue. Utilice STREAM para el modo streaming o BATCH para el modo por lotes.
  Engine Version	Para obtener más información sobre las versiones del motor, consulte Engine versions. Se recomienda utilizar la última versión sugerida.
  Deployment Target	La cola de recursos para el despliegue. Para obtener más información, consulte Manage a resource queue.
  Deployment Type	Seleccione SQL.
  SQL Script	Haga clic en Open in external editor para abrir el editor local. Escriba su código DDL y DML. Nota El archivo abierto en el editor es un archivo virtual que no se almacena en el sistema de archivos real. Por lo tanto, si vuelve a abrir VS Code, una pestaña del editor correspondiente a un archivo virtual sin cerrar mostrará el mensaje de error The editor could not be opened because the file was not found. Para abrir el archivo, haga clic nuevamente en Open in external editor.
  Additional Dependencies	Las dependencias adicionales que requiere el trabajo. Introduzca la URI del archivo de dependencia de destino.
  Description	Opcional. Introduzca una descripción para el trabajo.

  Trabajo JAR

  Para obtener más información sobre las configuraciones de parámetros, consulte Deploy a JAR job.

  Parámetro	Descripción
  Deployment Name	El nombre del despliegue.
  Execution Mode	El modo de despliegue. Utilice STREAM para el modo streaming o BATCH para el modo por lotes.
  Engine Version	La versión del motor. Para obtener más información, consulte Engine versions. Se recomienda utilizar la última versión sugerida.
  Deployment Target	La cola de recursos para el despliegue. Para obtener más información, consulte Manage a resource queue.
  Deployment Type	El tipo de trabajo a desplegar. Seleccione JAR.
  JAR URI	La ruta de OSS o la URL del paquete JAR. Asegúrese de haber cargado los archivos de dependencia relevantes en Artifacts en la Development Console o en un bucket de OSS vinculado, y de haber obtenido la ruta correspondiente.
  Entry Point Class	La clase principal a ejecutar. Obligatorio si el manifiesto JAR no especifica una clase principal.
  Entry Point Main Arguments	Introduzca los argumentos de entrada que se pasarán al método principal.
  Additional Dependencies	Introduzca la ruta de OSS o la URL de los archivos de dependencia adicionales. Actualmente, solo se admiten URLs que terminan con un nombre de archivo. Asegúrese de haber cargado los archivos de dependencia relevantes en Artifacts en la Development Console o en un bucket de OSS vinculado, y de haber obtenido la ruta correspondiente.
  Description	Opcional. Introduzca una descripción para el trabajo.

  Trabajo Python

  Para obtener más información sobre las configuraciones de parámetros, consulte Deploy a Python job.

  Parámetro	Descripción
  Deployment Name	El nombre del despliegue.
  Execution Mode	El modo de despliegue. Utilice STREAM para el modo streaming o BATCH para el modo por lotes.
  Engine Version	La versión del motor. Para obtener más información, consulte Engine versions. Se recomienda utilizar la última versión sugerida.
  Deployment Target	La cola de recursos para el despliegue. Para obtener más información, consulte Manage a resource queue.
  Deployment Type	El tipo de trabajo a desplegar. Seleccione Python.
  Python URI	La URI del archivo de trabajo de Python, que puede ser un archivo .py o .zip.
  Entry Module	El módulo de entrada a ejecutar. No es obligatorio para archivos .py. Obligatorio para archivos .zip.
  Entry Point Main Arguments	Introduzca los argumentos de entrada que se pasarán al método principal.
  Python Libraries	Paquetes de Python de terceros. Estos paquetes se agregan al PYTHONPATH del proceso de trabajo de Python, lo que los hace directamente accesibles en funciones definidas por el usuario en Python. Para obtener información sobre cómo usar paquetes de Python de terceros, consulte Use third-party Python packages.
  Python Archives	Archivos comprimidos. Para obtener más información, consulte Use a custom Python virtual environment y Use data files.
  Additional Dependencies	Introduzca la ruta de OSS o la URL de los archivos de dependencia adicionales. Asegúrese de haber cargado los archivos de dependencia relevantes en Artifacts en la Development Console o en un bucket de OSS vinculado, y de haber obtenido la ruta correspondiente.
  Description	Opcional. Introduzca una descripción para el trabajo.

• Resources: Para obtener más información sobre los parámetros de recursos del trabajo, consulte Configure job resources.

• Parameters: Para obtener más información sobre los parámetros de ejecución del trabajo, consulte Configure runtime parameters.

Paso 3: Desplegar el trabajo

Una vez que termine de desarrollar o configurar el trabajo, haga clic en Create en la parte inferior para desplegar un nuevo trabajo, o haga clic en Update para actualizar y desplegar un trabajo local existente.

Para trabajos SQL, la extensión valida el script SQL, el plan de recursos y otras configuraciones; posteriormente muestra los resultados de la validación.

Paso 4: Iniciar el trabajo

Para un trabajo desplegado, el estado más reciente se muestra en la esquina superior derecha. Puede hacer clic en Start y seleccionar un modo de inicio. Para obtener más información sobre los modos de inicio, consulte Start a job.

Paso 5: Operación y mantenimiento del trabajo

Después de desplegar y poner en marcha el trabajo, aparece un estado RUNNING en verde en la barra de acciones en la parte superior del editor. El área Basic muestra información clave del despliegue en una tabla, incluidos Deployment ID, Deployment Name, Execution Mode, Engine Version (por ejemplo, vvr-8.0.7-flink-1.17), Deployment Target y Deployment Type.

• Open Online: Haga clic en Open Online para abrir la página de operación y mantenimiento del trabajo en la Development Console, donde podrá consultar el estado de ejecución y realizar operaciones de gestión.

• Synchronize: Extrae la configuración del trabajo desde la nube. Al hacer clic en Synchronize se abre una vista previa de la configuración en línea. Nota: La vista previa no incluye cambios en borrador realizados en trabajos SQL desde la consola. Haga clic en Accept para sobrescribir su archivo local con la configuración en línea.

• Cancel: Detiene el trabajo en ejecución.