EXECUTE IMMEDIATE FROM¶

Syntax¶

EXECUTE IMMEDIATE
  FROM { absoluteFilePath | relativeFilePath }

Wobei:

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

Copy

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

Copy

Rückgabewerte¶

EXECUTE IMMEDIATE FROM Rückgabewerte:

• Das Ergebnis der letzten Anweisung in der Datei, wenn alle Anweisungen erfolgreich ausgeführt wurden.

• Die Fehlermeldung, wenn eine Anweisung in der Datei fehlgeschlagen ist.

  Wenn in einer Anweisung in der Datei ein Fehler auftritt, schlägt der Befehl EXECUTE IMMEDIATE FROM fehl und gibt die Fehlermeldung der fehlgeschlagenen Anweisung zurück.

  Bemerkung

  Wenn der Befehl EXECUTE IMMEDIATE FROM fehlschlägt und eine Fehlermeldung zurückgibt, sind alle Anweisungen in der Datei vor der fehlgeschlagenen Anweisung erfolgreich abgeschlossen worden.

Anforderungen an die Zugriffssteuerung¶

• Die Rolle, die zur Ausführung des Befehls EXECUTE IMMEDIATE FROM verwendet wird, muss über die Berechtigung USAGE (externer Stagingbereich) oder READ (interner Stagingbereich) für den Stagingbereich verfügen, in dem sich die Datei befindet.

• Die Rolle, mit der die Datei ausgeführt wird, kann nur die Anweisungen in der Datei ausführen, für die sie Berechtigungen hat. Wenn beispielsweise eine CREATE TABLE-Anweisung in der Datei enthalten ist, muss die Rolle über die notwendigen Berechtigungen verfügen, um eine Tabelle im Konto zu erstellen, sonst schlägt die Anweisung fehl.

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

• Die SQL-Anweisungen in einer auszuführenden Datei können EXECUTE IMMEDIATE FROM-Anweisungen enthalten:

  • Verschachtelte EXECUTE IMMEDIATE FROM-Anweisungen können relative Dateipfade verwenden.

    Relative Pfade werden in Bezug auf den Stagingbereich und den Dateipfad der übergeordneten Datei ausgewertet. Wenn der relative Dateipfad mit / beginnt, beginnt der Pfad im Stammverzeichnis des Stagingbereichs, der die übergeordnete Datei enthält.

    Ein Beispiel dazu finden Sie unter Beispiele.

  • Relative Dateipfade müssen in einfache Anführungszeichen (') oder $$ gesetzt wird.

  • Die maximale Ausführungstiefe für verschachtelte Dateien ist 5.

• Absolute Dateipfade können optional in einfache Anführungszeichen (') oder $$ gesetzt werden.

• Die auszuführende Datei darf nicht größer als 10MB sein.

• Die auszuführende Datei muss in UTF-8 kodiert sein.

• Die auszuführende Datei muss unkomprimiert sein. Wenn Sie den Befehl PUT verwenden, um eine Datei in einen internen Stagingbereich hochzuladen, müssen Sie den Parameter AUTO_COMPRESS explizit auf FALSE setzen.

  Laden Sie zum Beispiel my_file.sql nach my_stage hoch:

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

  Copy

• Das Ausführen aller Dateien in einem Verzeichnis wird nicht unterstützt. Zum Beispiel führt EXECUTE IMMEDIATE FROM @stage_name/scripts/ zu einem Fehler.

Problembehandlung von EXECUTE IMMEDIATE FROM-Fehler¶

Dieser Abschnitt enthält einige häufige Fehler, die sich aus einer EXECUTE IMMEDIATE FROM-Anweisung ergeben, und wie Sie diese beheben können.

• Dateifehler

• Stagingbereichsfehler

• Zugriffssteuerungsfehler

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>'

Beispiele¶

In diesem Beispiel wird die Datei create-inventory.sql ausgeführt, die sich im Stagingbereich my_stage befindet.

1. Erstellen Sie eine Datei namens create-inventory.sql mit den folgenden Anweisungen:

   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. Erstellen Sie eine Datei namens insert-inventory.sql mit den folgenden Anweisungen:

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

   Copy

3. Erstellen Sie einen internen Stagingbereich my_stage:

   CREATE STAGE my_stage;
   

   Copy

4. Laden Sie beide lokalen Dateien mit dem Befehl PUT in den Stagingbereich hoch:

   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. Führen Sie das Skript create-inventory.sql aus, das sich in my_stage befindet:

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

   Copy

   Rückgabewerte:

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