EXECUTE IMMEDIATE FROM¶

Syntaxe¶

EXECUTE IMMEDIATE
  FROM { absoluteFilePath | relativeFilePath }

Où :

absoluteFilePath ::=
   @[ <namespace>. ]<stage_name>/<path>/<filename>

Copy

relativeFilePath ::=
  '[ { ./ | / | { ../ [ , ../, ... ] } } ]<path>/<filename>'

Copy

Renvoie¶

EXECUTE IMMEDIATE FROM renvoie :

• Le résultat de la dernière instruction du fichier si toutes les instructions ont été exécutées avec succès.

• Le message d’erreur, si une instruction du fichier a échoué.

  En cas d’erreur dans une instruction dans le fichier, la commande EXECUTE IMMEDIATE FROM échoue et renvoie le message d’erreur de l’instruction défaillante.

  Note

  Si la commande EXECUTE IMMEDIATE FROM échoue et renvoie un message d’erreur, toutes les instructions du fichier précédant l’instruction ayant échoué se sont achevées avec succès.

Exigences en matière de contrôle d’accès¶

• Le rôle utilisé pour exécuter la commande EXECUTE IMMEDIATE FROM doit avoir le privilège USAGE (zone de préparation externe) ou READ (zone de préparation interne) sur la zone de préparation où se trouve le fichier.

• Le rôle utilisé pour exécuter le fichier ne peut exécuter que les instructions du fichier pour lesquelles il dispose de privilèges. Par exemple, si le fichier contient une instruction CREATE TABLE, le rôle doit disposer des privilèges nécessaires pour créer une table dans le compte, faute de quoi l’instruction échoue.

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

• Les instructions SQL d’un fichier à exécuter peuvent inclure des instructions EXECUTE IMMEDIATE FROM :

  • Les instructions EXECUTE IMMEDIATE FROM imbriquées peuvent utiliser des chemins de fichiers relatifs.

    Les chemins relatifs sont évalués par rapport à la zone de préparation et au chemin d’accès du fichier parent. Si le chemin d’accès relatif au fichier commence par /, le chemin d’accès commence au répertoire racine de la zone de préparation contenant le fichier parent.

    Pour un exemple, voir Exemples.

  • Les chemins d’accès relatifs aux fichiers doivent être placés entre guillemets simples (') ou ($$).

  • La profondeur d’exécution maximale pour les fichiers imbriqués est de 5.

• Les chemins d’accès absolus aux fichiers peuvent éventuellement être placés entre guillemets simples (') ou ($$).

• Le fichier à exécuter ne peut pas avoir une taille supérieure à 10MB.

• Le fichier à exécuter doit être codé en UTF-8.

• Le fichier à exécuter doit être décompressé. Si vous utilisez la commande PUT pour télécharger un fichier vers une zone de préparation interne, vous devez explicitement définir le paramètre AUTO_COMPRESS sur FALSE.

  Par exemple, télécharger my_file.sql vers my_stage :

  PUT file://~/sql/scripts/my_file.sql @my_stage/scripts/
    AUTO_COMPRESS=FALSE;
  

  Copy

• L’exécution de tous les fichiers d’un répertoire n’est pas possible. Par exemple, EXECUTE IMMEDIATE FROM @stage_name/scripts/ entraîne une erreur.

Dépannage d’erreurs EXECUTE IMMEDIATE FROM¶

Cette section présente quelques erreurs courantes résultant d’une instruction EXECUTE IMMEDIATE FROM et explique comment les résoudre.

• Erreurs de fichiers

• Erreurs de zone de préparation

• Erreurs de contrôle d’accès

001501 (02000): File '<directory_name>' not found in stage '<stage_name>'.

001503 (42601): Relative file references like '<filename.sql>' cannot be used in top-level EXECUTE IMMEDIATE calls.

001003 (42000): SQL compilation error: syntax error line <n> at position <m> unexpected '<string>'.

002003 (02000): SQL compilation error: Stage '<stage_name>' does not exist or not authorized.

003001 (42501): Uncaught exception of type 'STATEMENT_ERROR' in file <file_name> on line <n> at position <m>:
SQL access control error: Insufficient privileges to operate on schema '<schema_name>'

Exemples¶

Cet exemple exécute le fichier create-inventory.sql situé dans la zone de préparation my_stage.

1. Créer un fichier nommé create-inventory.sql avec les instructions suivantes :

   CREATE OR REPLACE TABLE my_inventory(
     sku VARCHAR,
     price NUMBER
   );
   
   EXECUTE IMMEDIATE FROM './insert-inventory.sql';
   
   SELECT sku, price
     FROM my_inventory
     ORDER BY price DESC;
   

   Copy

2. Créer un fichier nommé insert-inventory.sql avec les instructions suivantes :

   INSERT INTO my_inventory
     VALUES ('XYZ12345', 10.00),
            ('XYZ81974', 50.00),
            ('XYZ34985', 30.00),
            ('XYZ15324', 15.00);
   

   Copy

3. Créer une zone de préparation interne my_stage :

   CREATE STAGE my_stage;
   

   Copy

4. Télécharger les deux fichiers locaux sur la zone de préparation à l’aide de la commande PUT :

   PUT file://~/sql/scripts/create-inventory.sql @my_stage/scripts/
     AUTO_COMPRESS=FALSE;
   
   PUT file://~/sql/scripts/insert-inventory.sql @my_stage/scripts/
     AUTO_COMPRESS=FALSE;
   

   Copy

5. Exécuter le script create-inventory.sql situé dans my_stage :

   EXECUTE IMMEDIATE FROM @my_stage/scripts/create-inventory.sql;
   

   Copy

   Renvoie :

   +----------+-------+
   | SKU      | PRICE |
   |----------+-------|
   | XYZ81974 |    50 |
   | XYZ34985 |    30 |
   | XYZ15324 |    15 |
   | XYZ12345 |    10 |
   +----------+-------+