Ir al contenido

Importa el resultado de una consulta SQL contra una base de datos externa en una tabla de proyecto de PlaidCloud. La consulta se ejecuta en la base de datos remota; solo el conjunto de resultados se trae a PlaidCloud.

Se diferencia de Importar tablas de bases de datos externas en que usted escribe el SQL: es útil para combinaciones, filtros o agregaciones complejos que desea que realice la base de datos de origen antes de que los datos lleguen a PlaidCloud.

Tabla de Importar SQL


Para establecer una Conexión de base de datos, consulte Conexiones de datos de PlaidCloud

Tabla de destino

La selección de destino para las importaciones se limita a tablas, ya que las vistas no contienen datos subyacentes.

Opción dinámica

La opción dinámica permite especificar una tabla mediante texto, incluidas variables. Esto resulta útil en flujos de trabajo controlados por variables, en los que las referencias a tablas y vistas son relativas a las variables especificadas.

Un ejemplo que usa la variable current_month para apuntar dinámicamente a la tabla de destino:

legal_entity/inputs/{current_month}/ledger_values

Opción estática

Cuando se desea una tabla concreta como destino de la importación, deje sin marcar la casilla Dinámico y seleccione la tabla de destino.

Si la tabla de destino no existe, seleccione el botón Crear nuevo para crear la tabla en la ubicación deseada.

El Explorador de tablas está siempre disponible con cualquier selección de tabla. Haga clic en el botón Explorador de tablas situado a la derecha de la selección de tabla y se abrirá una ventana del Explorador de tablas.

En esta sección escriba la consulta SQL que devuelve los datos necesarios.

Vista previa

Haga clic en Vista previa en la pestaña Origen para ver hasta 100 filas de lo que leería el paso, sin ejecutarlo. Si el resultado es más largo, la vista previa indica que muestra las primeras filas y que debe ejecutar el paso para leerlas todas.

La vista previa rellena las variables del proyecto y del flujo de trabajo de la misma manera que una ejecución. No admite formatos de variable como {x:>9} y no puede rellenar una variable que solo tiene valor durante una ejecución, como un valor de activación.

La vista previa solo lee datos. Rechaza una consulta que pudiera cambiar algo y muestra un mensaje en lugar de filas:

  • La vista previa solo admite funciones SQL estándar. Ejecute el paso para ver los resultados. La consulta usa una función que la vista previa no puede comprobar como de solo lectura. Ejecute el paso para ver el resultado.
  • Se rechaza una consulta que no sea un único SELECT, o cuyas variables se expandan en una instrucción que escribe.

La vista previa no está disponible en un proyecto bloqueado, en conexiones de SQL Server, Oracle o SQLite, ni para los pasos que se ejecutan a través de un agente, como Agent Remote Execution of SQL.

Las importaciones de SQL ofrecen la opción de intentar detectar el tipo de datos durante la carga, o de establecer todas las columnas con el tipo Texto. Establecer los tipos de datos de forma dinámica puede ser más rápido si los datos están limpios, pero puede causar problemas en algunas circunstancias.

Por ejemplo, si la mayoría de los datos parecen numéricos pero también hay algo de texto, puede intentar establecerlos como numéricos y causar problemas de carga por tipos de datos que no coinciden. O puede haber problemas si hay un código de producto numérico de 16 dígitos, por ejemplo. Recortaría los ceros iniciales y el resultado sería un número en lugar de un código de 16 dígitos.

Sin embargo, establecer todos los datos como texto requiere un paso de extracción posterior para convertir los tipos de datos que no deberían ser texto al tipo adecuado, como fechas o valores numéricos.


Síntoma Causa probable
El paso tardó notablemente más de lo habitual (hasta aproximadamente media hora más) sin que cambiara nada más en su consulta, su conexión o el volumen de datos El proceso de trabajo en segundo plano que ejecutaba la importación se interrumpió a mitad de camino (un reinicio o desalojo del lado de la plataforma, no algo de su flujo de trabajo) y la plataforma reintentó por usted la importación de la tabla. El reintento solo comienza cuando se detecta la interrupción, lo que explica el tiempo adicional.
El paso terminó correctamente después de ese retraso El reintento reemplaza por completo el contenido de la tabla, por lo que el resultado es el mismo que el de una única ejecución limpia: no hay nada más que comprobar ni rehacer.
El paso falla con «has already been attempted and cannot be safely re-run» Para un paso Importar SQL, este rechazo ya no se produce: una interrupción a mitad de la ejecución se reintenta. Seguirá viéndolo, por diseño, al restaurar un archivo de proyecto o al cargar una dimensión, donde volver a ejecutar crearía un duplicado en lugar de reemplazar algo. Abra un ticket de soporte si lo ve en un paso Importar SQL.