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 están definidas por 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 el documento Sintaxis SQL en Query Service 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 conserva el resultado de una consulta SELECT 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. Para obtener más 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 la 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 usan los bloques anónimos con el patrón de diseño de carga incremental para aumentar la eficacia de la consulta.