DROP ACCOUNT

Löscht ein Konto, wodurch der Prozess der permanenten Löschung des Kontos initiiert wird.

Tipp

Neben SQL können Sie auch andere Weboberflächen verwenden, wie Snowflake REST APIs, Snowflake Python APIs und Snowflake CLI. Siehe Alternative Weboberflächen.

Siehe auch:

CREATE ACCOUNT, SHOW ACCOUNTS, UNDROP ACCOUNT

Syntax

DROP ACCOUNT [ IF EXISTS ] <name> GRACE_PERIOD_IN_DAYS = <integer>
Copy

Parameter

name

Gibt den Namen des zu löschenden Kontos an. Wenn der vollständige Kontobezeichner beispielsweise myorg-account123 lautet, geben Sie account123 als Namen an. Wenn Sie den Namen des Kontos nicht kennen, führen Sie den Befehl SHOW ACCOUNTS aus, und entnehmen Sie dann den Namen der Spalte account_name.

Der veraltete Konto-Locator kann nicht zur Identifizierung des Kontos verwendet werden.

GRACE_PERIOD_IN_DAYS = integer

Gibt die Anzahl der Tage an, in denen das Konto wiederhergestellt werden kann („undrop“). Die Mindestdauer beträgt 3 Tage und die Höchstdauer 90 Tage.

Nutzungshinweise

  • Nur Organisationsadministratoren können den Befehl ausführen.

  • Der Organisationsadministrator kann das Konto, bei dem er gerade angemeldet ist, nicht löschen.

  • Wenn die IF EXISTS-Klausel angegeben ist und das Zielobjekt nicht vorhanden ist, wird der Befehl erfolgreich abgeschlossen, ohne dass ein Fehler zurückgegeben wird.

Wichtig

Wenn das Konto ein Snapshot-Set enthält, dem eine Snapshot-Richtlinie mit einer Aufbewahrungssperre zugeordnet ist, und noch nicht abgelaufene Snapshots im Snapshot-Set vorhanden sind, dann können Sie das Konto, das das Snapshot-Set enthält, nicht löschen. In diesem Fall müssen Sie warten, bis alle Snapshots im Set abgelaufen sind. Diese Einschränkung gilt auch für privilegierte Rollen wie ACCOUNTADMIN und für den Snowflake-Support. Aus diesem Grund sollten Sie vorsichtig sein, wenn Sie in einer Snapshot-Richtlinie eine Aufbewahrungssperre und einen langen Ablaufzeitpunkt angeben.

Beispiel

Um das Konto my_account zu löschen und eine 14-tägige Übergangsfrist für die Wiederherstellung des Kontos zu gewähren, geben Sie Folgendes ein:

DROP ACCOUNT my_account GRACE_PERIOD_IN_DAYS = 14;
Copy

Alternative Weboberflächen