Kategorien:

Systemfunktionen (Systeminformationen)

SYSTEM$LOCATE_DBT_ARCHIVE

Gibt die URL zurück, von der Sie komprimierte dbt-Ausführungsartefakte für ein bestimmtes dbt-Projekt abrufen können.

Verwenden Sie diese Funktion mit der DBT_PROJECT_EXECUTION_HISTORY-Funktion für den programmgesteuerten Zugriff auf dbt-Artefakte und -Protokolle.

Syntax

SYSTEM$LOCATE_DBT_ARCHIVE ( '<query_id>' )
Copy

Argumente

query_id

Die Abfrage-ID der dbt-Projektausführung, deren Dateien Sie suchen möchten.

Rückgabewerte

Diese Funktion gibt die URL zurück, von der Sie den komprimierten Inhalt der Ergebnisse eines bestimmten dbt-Projekts abrufen können.

Weitere Informationen und Beispiele dazu finden Sie unter Programmgesteuert auf dbt-Artefakte und -Protokolle zugreifen.

Anforderungen an die Zugriffssteuerung

Diese Funktion umfasst nur Ausführungen aus Arbeitsbereichen und dbt-Projekten, in denen Sie über die folgenden Berechtigungen verfügen:

  • OWNERSHIP oder USAGE für Arbeitsbereiche

  • OWNERSHIP, USAGE oder MONITOR für dbt-Projekte

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen. Beachten Sie, dass eine Rolle, die eine beliebige Berechtigung für ein Schema erhalten hat, es dieser Rolle erlaubt, das Schema aufzulösen. Zum Beispiel kann eine Rolle, der die CREATE-Berechtigung für ein Schema gewährt wurde, Objekte in diesem Schema erstellen, ohne auch USAGE für dieses Schema gewährt bekommen zu haben.

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

  • Diese Systemfunktion funktioniert nur für dbt-Projektobjekte. Sie ist nicht für Arbeitsbereiche verfügbar.

  • Abfrage-IDs, die von CREATE DBT PROJECT oder ALTER DBT PROJECT … ADD VERSION generiert wurden, werden bei dieser Systemfunktion nicht unterstützt.

  • Direkte Abfragen von Dateiinhalten (z. B. Abfragebeispiele) werden nicht unterstützt.

  • Wenn query_id NULL oder keine dbt-Ausführung ist, erhalten Sie einen Fehler.

  • dbt-Projektergebnisse sind bis zu 14 Tage lang verfügbar.

  • Dateien sind möglicherweise nicht verfügbar, wenn für eine Ausführung eine Zeitüberschreitung auftritt, die Ausführung abgebrochen wird oder fehlschlägt, bevor sie hochgeladen werden. In solchen Fällen werden die Ausführungen im dbt-Verlauf als UNHANDLED ERROR angezeigt.

  • Sie können diese Funktion nicht verwenden, um Protokolle für laufende Ausführungen zu erhalten, da die Protokolldatei erst nach Abschluss der Ausführung verfügbar ist.

Beispiele

Das folgende Beispiel gibt die snow:// URL der komprimierten Artefakte (z. B. dbt_artifacts.zip) für die angegebene Ausführung zurück.

Sie können diese URL mit GET verwenden, um die ZIP-Datei herunterzuladen (oder COPY FILES, um sie in Ihren eigenen Stagingbereich zu verschieben). Verwenden Sie für den Ordnerpfad SYSTEM$LOCATE_DBT_ARTIFACTS anstelle der ZIP.

SELECT SYSTEM$LOCATE_DBT_ARCHIVE($latest_query_id);
Copy

Weitere Informationen dazu finden Sie unter Programmgesteuert auf dbt-Artefakte und -Protokolle zugreifen.

Sprache: Deutsch