SYSTEM$CANCEL_CLASSIFY_SCHEMA¶

Plant den Abbruch der Klassifizierung für die Tabellen des angegebenen Schemas. Sie können den Klassifizierungsprozess für Tabellen abbrechen, auf die die Rolle, mit der Sie diese Prozedur aufrufen, Zugriff hat.

Eine Tabelle, bei der der Klassifizierungsprozess abgebrochen wurde, ist nicht klassifiziert, bis Sie die Tabelle erneut klassifizieren.

Syntax¶

SYSTEM$CANCEL_CLASSIFY_SCHEMA( '<object_name>' )

Copy

Argumente¶

object_name

Der Name des Schemas, das die Tabellen enthält, bei denen der Klassifizierungsprozess abgebrochen werden soll. Wenn in der aktuellen Sitzung weder Datenbank noch Schema verwendet werden, muss der Name vollqualifiziert sein.

Der Name muss genau so angegeben werden, wie er in der Datenbank gespeichert ist. Enthält der Name Sonderzeichen, Großbuchstaben oder Leerzeichen, muss der Name zuerst in Anführungszeichen und dann in einfache Anführungszeichen gesetzt werden.

Rückgabewerte¶

Die gespeicherte Prozedur gibt ein JSON-Objekt in den folgenden Formaten zurück, abhängig vom angegebenen Schemanamen:

Wenn Sie SYSTEM$CLASSIFY_SCHEMA aufrufen, um die Klassifizierung durchzuführen, und dann SYSTEM$CANCEL_CLASSIFY_SCHEMA mit demselben Schemanamen aufrufen, um den Klassifizierungsprozess abzubrechen, sieht die Ausgabe wie folgt aus:

{
  "failed": [],
  "succeeded": [
    {
      "message": "Classification Cancelled for table [T1].",
      "table_name": "T1"
    },
    {
      "message": "Classification Cancelled for table [T2].",
      "table_name": "T2"
    },
    ...
    }
  ]
}

Copy

Wenn Sie SYSTEM$CANCEL_CLASSIFY_SCHEMA aufrufen und das angegebene Schema nicht im Stagingbereich für die Klassifizierung liegt, lautet die Ausgabe wie folgt:

{
  "failed": [
    {
      "message": "Unable to cancel classification for table [T1] since its already complete.",
      "table_name": "T1"
    },
    {
      "message": "Unable to cancel classification for table [T2] since its already complete.",
      "table_name": "T2"
    },
    ...
  ],
  "succeeded": []
}

Copy

Wobei:

failed: Gibt einen Grund an, warum der Stornierungsvorgang für die angegebene Tabelle nicht durchgeführt werden kann.
succeeded: Bestätigt, dass der Stornierungsvorgang für die angegebene Tabelle geplant ist.

Nutzungshinweise¶

Der Stornierungsvorgang kann etwas Zeit (Sekunden) in Anspruch nehmen. Dies ist analog zum Abbruch einer Anfrage.
Das angegebene Schema kann bis zu 1.000 Tabellenobjekte enthalten. Wenn das Schema mehr als 1.000 Tabellenobjekte enthält, gibt Snowflake eine Fehlermeldung zurück.
Von Snowflake bereitgestellte gespeicherte Prozeduren nutzen Aufruferrechte. Weitere Details dazu finden Sie unter Erläuterungen zu gespeicherten Prozeduren mit Aufruferrechten und Eigentümerrechten.

Beispiele¶

Bricht die Klassifizierung von Tabellen im Schema ab:

CALL SYSTEM$CANCEL_CLASSIFY_SCHEMA('hr.tables');

Copy