Bloc anonyme dans le service de requête

Le service de requête Adobe Experience Platform prend en charge les blocs anonymes. La fonction de bloc anonyme vous permet d’enchaîner une ou plusieurs instructions SQL exécutées de manière séquentielle. Les blocs anonymes permettent également de gérer les exceptions.

La fonction de bloc anonyme est un moyen efficace d’effectuer une séquence d’opérations ou de requêtes. La chaîne de requêtes au sein du bloc peut être enregistrée comme modèle et planifiée pour s’exécuter à un moment ou à un intervalle spécifique. Ces requêtes peuvent être utilisées pour écrire et ajouter des données afin de créer un jeu de données. Elles sont généralement utilisées avec une dépendance.

Le tableau ci-dessous présente la répartition des principales sections du bloc : exécution et gestion des exceptions. Les sections sont définies par les mots-clés BEGIN, END et EXCEPTION.

Il est intéressant de noter qu’un bloc est une instruction exécutable et peut donc être imbriqué dans d’autres blocs.

Exemples de requêtes en blocs anonymes

La requête suivante illustre un exemple de chaîne d’instructions SQL. Reportez-vous au document Syntaxe SQL dans le service de requête pour plus d’informations sur les syntaxes SQL utilisées.

$$ 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 OTHERS THEN SET @ret = SELECT 'ERROR';
END
$$;

Dans l’exemple ci-dessous, SET conserve le résultat d’une requête SELECT dans la variable locale spécifiée. La variable est étendue sur le bloc anonyme.

L’ID d’instantané est stocké en tant que variable locale (@current_sid). Elle est ensuite utilisée dans la requête suivante pour renvoyer les résultats en fonction de l’INSTANTANÉ du même jeu de données/du même tableau. Pour plus d’informations sur la clause d’instantané, consultez la documentation sur la syntaxe 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
$$;

Bloc anonyme avec clients tiers third-party-clients

Certains clients tiers peuvent avoir besoin d’un identifiant distinct avant et après un bloc SQL pour indiquer qu’une partie du script doit être traitée comme une seule instruction. Si vous recevez un message d’erreur lors de l’utilisation de Query Service avec un client tiers, vous devez vous reporter à la documentation du client tiers concernant l’utilisation d’un bloc SQL.

Par exemple, la mention DbVisualizer requiert que le délimiteur soit le seul texte de la ligne. Dans DbVisualizer, la valeur par défaut de l’identifiant de début est --/ et celle de l’identifiant de fin est /. Vous trouverez ci-dessous un exemple de bloc anonyme dans 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 OTHERS THEN SET @ret = SELECT 'ERROR';
END
$$;
/

Pour DbVisualizer en particulier, il existe également une option « Execute the complete buffer as one SQL statement » dans l’interface utilisateur. Pour plus d’informations, consultez la documentation de DbVisualizer.

Étapes suivantes

En lisant ce document, vous avez aquis une compréhension claire des blocs anonymes et de leur structure. Veuillez lire le guide d’exécution des requêtes pour plus d’informations sur l’écriture de requêtes.

Vous devez également en savoir plus sur la manière dont les blocs anonymes sont utilisés avec le modèle de conception de chargement incrémentiel pour augmenter l’efficacité des requêtes.