Kategorien:: Systemfunktionen (Systeminformationen)

SYSTEM$VERIFY_EXTERNAL_VOLUME¶

Überprüft die Konfiguration für ein angegebenes externes Volume.

Bei externen Volumes mit Schreibzugriff versucht Snowflake die folgenden zusätzlichen Operationen, um die Konfiguration zu überprüfen:

Schreiben einer Testdatei.
Lesen der Testdatei.
Auflistung der Dateien im Speicherort.
Löschen der Testdatei.

Siehe auch:: Speicher für Apache Iceberg™-Tabellen , Externes Volume konfigurieren , CREATE EXTERNAL VOLUME

Syntax¶

SYSTEM$VERIFY_EXTERNAL_VOLUME('<external_volume_name>')

Copy

Argumente¶

external_volume_name: Name des zu überprüfenden externen Volumes. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelten Anführungszeichen eingeschlossen sind, wird ebenfalls zwischen Groß- und Kleinschreibung unterschieden.

Rückgabewerte¶

Die Funktion gibt ein JSON-Objekt mit den unten beschriebenen Eigenschaften zurück:

Eigenschaft	Beschreibung
`success`	Der Status des Verifizierungstests. Gibt `TRUE` zurück, wenn alle Aktionen beendet wurden; gibt `FALSE` zurück, wenn eine Aktion nicht wie erwartet beendet wurde.
`storageLocationSelectionResult`	Das Ergebnis der Auswahl eines aktiven Speicherortes für das externe Volume. Gibt `TRUE` zurück, wenn Snowflake erfolgreich einen aktiven Speicherort auswählen kann, andernfalls `FALSE`.
`storageLocationName`	Der Name des aktiven Speicherorts.
`servicePrincipalProperties`	Die Eigenschaften des Snowflake-Dienstprinzipals für den Cloudanbieter des aktiven Speicherorts.
`location`	Die `BASE_URL` des aktiven Speicherorts.
`storageAccount`	Bei Azure das Speicherkonto des aktiven Speicherorts.
`region`	Die Region des aktiven Speicherorts.
`writeResult`	Das Ergebnis des Schreibens einer Datei in den aktiven Speicherort. Übersprungen für schreibgeschützte externe Volumes.
`readResult`	Das Ergebnis des Lesens einer Datei aus dem aktiven Speicherort. Übersprungen für schreibgeschützte externe Volumes.
`listResult`	Das Ergebnis der Auflistung des Inhalts des aktiven Speicherorts. Übersprungen für schreibgeschützte externe Volumes.
`deleteResult`	Das Ergebnis des Löschens einer in den aktiven Speicherort geschriebenen Testdatei. Übersprungen für schreibgeschützte externe Volumes.
`awsRoleArnValidationResult`	Gibt für Amazon S3 das Ergebnis der Validierung des Amazon Resource Name (ARN) für die IAM-Rolle zurück, die von dem externen Volume verwendet wird.
`azureGetUserDelegationKeyResult`	Gibt für Azure das Ergebnis des Abrufs eines Schlüssels für die Benutzerdelegierung zurück.

Ergebniswerte¶

Rückgabeeigenschaften, die auf ein Ergebnis hinweisen, können die folgenden Werte annehmen:

Ergebniswert	Beschreibung
`PASSED`	Die Operation war erfolgreich.
`SKIPPED`	Die Operation ist für das angegebene externe Volumen nicht anwendbar. Zum Beispiel werden die Operationen Lesen, Schreiben, Auflisten und Löschen für externe Volumes mit Lesezugriff übersprungen.
`<error_message>`	Eine detaillierte Fehlermeldung.

Beispielausgabe:¶

{
  "success": true,
  "storageLocationSelectionResult": "PASSED",
  "storageLocationName": "my-azure-westus-1",
  "servicePrincipalProperties": "AZURE_MULTI_TENANT_APP_NAME: powerful-azure-ad-auth-test-snowflake-app_...; AZURE_CONSENT_URL: https://login.microsoftonline.com...",
  "location": "azure://myStorageAccount.blob.core.windows.net/myStorageLocation/",
  "storageAccount": "myStorageAccount",
  "region": "westus",
  "writeResult": "PASSED",
  "readResult": "PASSED",
  "listResult": "PASSED",
  "deleteResult": "PASSED",
  "awsRoleArnValidationResult": "SKIPPED",
  "azureGetUserDelegationKeyResult": "PASSED"
}

Copy

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung	Objekt	Anmerkungen
OWNERSHIP	Externes Volume

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.

Beispiele¶

Ein externes Volume mit dem Namen my_s3_external_volume überprüfen:

SELECT SYSTEM$VERIFY_EXTERNAL_VOLUME('my_s3_external_volume');

Copy