Bloque anónimo en el servicio de consultas

El servicio de consultas de Adobe Experience Platform admite bloques anónimos. La función de bloque anónimo permite encadenar una o más sentencias SQL que se ejecutan en secuencia. También permiten la opción de la gestión de excepciones.

La función de bloques anónimos es una forma eficaz de realizar una secuencia de operaciones o consultas. La cadena de consultas dentro del bloque se puede guardar como plantilla y programarse para ejecutarse a una hora o intervalo determinados. Estas consultas se pueden utilizar para escribir y anexar datos para crear un nuevo conjunto de datos y, normalmente, se utilizan donde tiene una dependencia.

La tabla proporciona un desglose de las secciones principales del bloque: ejecución y control de excepciones. Las secciones se definen mediante las palabras clave BEGIN, END, y EXCEPTION.

Cabe señalar que un bloque es una instrucción ejecutable y, por lo tanto, se puede anidar dentro de otros bloques.

Ejemplos de consultas de bloque anónimas

La siguiente consulta muestra un ejemplo de encadenamiento de instrucciones SQL. Consulte la Sintaxis SQL en el servicio de consultas para obtener más información sobre cualquiera de las sintaxis SQL utilizadas.

$$ BEGIN
    CREATE TABLE ADLS_TABLE_A AS SELECT * FROM ADLS_TABLE_1....;
    ....
    CREATE TABLE ADLS_TABLE_D AS SELECT * FROM ADLS_TABLE_C....;
    EXCEPTION WHEN OTHER THEN SET @ret = SELECT 'ERROR';
END
$$;

En el ejemplo siguiente, SET persiste en el resultado de una SELECT consulta en la variable local especificada. La variable está vinculada al bloque anónimo.

El ID de instantánea se almacena como variable local (@current_sid). A continuación, se utiliza en la siguiente consulta para devolver resultados basados en la INSTANTÁNEA del mismo conjunto de datos o tabla.

Una instantánea de base de datos es una vista estática de sólo lectura de una base de datos de SQL Server. Para obtener más información información sobre la cláusula de instantánea consulte la documentación de sintaxis SQL.

$$ BEGIN
  SET @current_sid = SELECT parent_id  FROM (SELECT history_meta('your_table_name')) WHERE  is_current = true;
  CREATE temp table abcd_temp_table AS SELECT count(1) FROM your_table_name  SNAPSHOT SINCE @current_sid;
END
$$;

Bloque anónimo con clientes de terceros third-party-clients

Algunos clientes de terceros pueden requerir un identificador independiente antes y después de un bloque SQL para indicar que una parte de la secuencia de comandos debe gestionarse como una sola instrucción. Si recibe un mensaje de error al utilizar el servicio de consulta con un cliente de terceros, debe consultar la documentación del cliente de terceros sobre el uso de un bloque SQL.

Por ejemplo, DbVisualizer requiere que el delimitador sea el único texto de la línea. En DbVisualizer, el valor predeterminado para el Identificador inicial es --/ y para el Identificador final, es /. A continuación se muestra un ejemplo de bloque anónimo en DbVisualizer:

--/
$$ BEGIN
    CREATE TABLE ADLS_TABLE_A AS SELECT * FROM ADLS_TABLE_1....;
    ....
    CREATE TABLE ADLS_TABLE_D AS SELECT * FROM ADLS_TABLE_C....;
    EXCEPTION WHEN OTHER THEN SET @ret = SELECT 'ERROR';
END
$$;
/

Para DbVisualizer en particular, también hay una opción en la IU para "Execute the complete buffer as one SQL statement". Consulte la Documentación de DbVisualizer para obtener más información.

Pasos siguientes

Al leer este documento, ahora tiene una comprensión clara de los bloques anónimos y de cómo están estructurados. Lea el guía de ejecución de consultas para obtener más información sobre cómo escribir consultas.

También debería leer acerca de cómo se utilizan los bloques anónimos con el patrón de diseño de carga incremental para aumentar la eficacia de las consultas.