Ejecutar consulta personalizada

En esta página, se muestra cómo ejecutar una consulta en SQL personalizada. Para ejecutar una consulta personalizada, debes estar familiarizado con los siguientes conceptos:

• Crea integraciones con Application Integration
• Tarea de conector
• Conectores de Integration
• Consultas SQL

La sección Ejecutar consulta personalizada se expone como una acción en el Tarea de conector. Una acción es un primer elemento de clase que está disponible para la integración a través de la interfaz del conector. Acciones le permiten realizar cambios en una o varias entidades y variar de un conector a otro. Sin embargo, es posible que un conector no admite ninguna acción, en cuyo caso, la lista Actions estará vacía.

Los siguientes conectores admiten consultas personalizadas:

• BigQuery
• Cloud SQL - MySQL
• Cloud SQL - PostgreSQL
• Cloud SQL - SQL Server
• Couchbase
• Elasticsearch
• MySQL
• Base de datos de Oracle
• PostgreSQL
• Salesforce
• SQL Server
• Snowflake
• Spanner
• Terdata

Crear una consulta personalizada

Para crear una consulta personalizada, sigue estos pasos:

1. Sigue las instrucciones detalladas para agregar una tarea de conectores.
2. Cuando configures la tarea del conector, en el tipo de acción que desees realizar, selecciona Acciones.
3. En la lista Acción, selecciona Ejecutar consulta personalizada y, luego, haz clic en Listo.

   

4. Expande la sección Task input y, luego, haz lo siguiente:
   1. En el campo Tiempo de espera después, ingresa la cantidad de segundos que se debe esperar hasta que se ejecute la consulta.

      Valor predeterminado: 180 segundos.

   2. En el campo Cantidad máxima de filas, ingresa la cantidad máxima de filas que se mostrarán en la base de datos.

      Valor predeterminado: 25.

   3. Para actualizar la consulta personalizada, haz clic en Edit Custom Script (Editar secuencia de comandos personalizada). Se abrirá el diálogo Editor de secuencia de comandos.

      

   4. En el diálogo Editor de secuencia de comandos, ingresa la consulta en SQL y haz clic en Guardar.

      Puedes usar un signo de interrogación (?) en una instrucción de SQL para representar un parámetro único que debe especificarse en la lista de parámetros de consulta. Por ejemplo, la siguiente consulta en SQL selecciona todas las filas de la tabla Employees que coinciden con los valores especificados para la columna LastName:

      SELECT * FROM Employees where LastName=?

      Nota: Se admiten las declaraciones de lenguaje de manipulación de datos (DML) y lenguaje de definición de datos (DDL).
   5. Si usaste signos de interrogación en tu consulta en SQL, debes agregar el parámetro. Para ello, haz clic en + Agregar nombre del parámetro en cada signo de interrogación. Mientras se ejecuta la integración, estos parámetros reemplazan los signos de interrogación (?) en la consulta en SQL de manera secuencial. Por ejemplo, si agregaste tres signos de interrogación (?), debes agregar tres parámetros en orden de secuencia.

      

      Para agregar parámetros de consulta, haz lo siguiente:

      1. En la lista Tipo, selecciona el tipo de datos del parámetro.
      2. En el campo Valor, ingresa el valor del parámetro.
      3. Para agregar varios parámetros, haz clic en + Agregar parámetro de consulta.