Kategorien:: Systemfunktionen (Systeminformationen)

SYSTEM$GET_CLASSIFICATION_RESULT¶

Gibt das Klassifizierungsergebnis des angegebenen Objekts zurück.

Syntax¶

SELECT SYSTEM$GET_CLASSIFICATION_RESULT( '<object_name>' )

Copy

Argumente¶

object_name

Der Name der Tabelle, der externen Tabelle, der Ansicht oder der materialisierten Ansicht, die die zu klassifizierenden Spalten enthält. 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¶

Gibt ein JSON-Objekt im folgenden Format zurück. Beispiel:

{
  "classification_result": {
    "col1_name": {
      "alternates": [],
      "recommendation": {
        "confidence": "HIGH",
        "coverage": 1,
        "details": [
          {
            "coverage": 1,
            "semantic_category": "US_PASSPORT"
          }
        ],
        "privacy_category": "IDENTIFIER",
        "semantic_category": "PASSPORT"
      },
      "valid_value_ratio": 1
    },  
    "col2_name": { ... },
    ...
  }
}

Copy

Wobei:

alternates: Gibt Informationen zu allen Tags und Werten an, die abgesehen vom empfohlenen Tag berücksichtigt werden sollen.
recommendation: Gibt Informationen zu jedem Tag und Wert als primäre Wahl auf Grundlage des Klassifizierungsprozesses an.

Diese Werte können sowohl in den Alternativen als auch in der Empfehlung angezeigt werden:

classifier_name
Der vollqualifizierte Name der kundenspezifischen Klassifizierungsinstanz, der zum Tagging der klassifizierten Spalte verwendet wurde.

Dieses Feld wird nur angezeigt, wenn eine kundenspezifische Klassifizierungsinstanz als Quelle für das auf eine Spalte zu setzende Tag verwendet wird.

confidence
Gibt einen der folgenden Werte an: HIGH, MEDIUM oder LOW. Dieser Wert gibt die relative Vertrauenswürdigkeit an, die Snowflake auf Grundlage des Spalten-Sampling-Prozesses hat, und wie die Spaltendaten mit der von Snowflake vorgenommenen Klassifizierung der Daten übereinstimmen.

coverage
Gibt den Prozentsatz der Stichprobenwerte in den Zellen an, die mit den Regeln einer bestimmten Kategorie übereinstimmen.

details
Gibt die Felder und Werte an, die auf einen geografischen Tag-Wert für das Tag SEMANTIC_CATEGORY verweisen können.

privacy_category
Gibt den Wert des Datenschutzkategorie-Tags an.

Mögliche Werte sind IDENTIFIER, QUASI-IDENTIFIER und SENSITIVE.

semantic_category
Gibt den Wert des semantischen Kategorie-Tags an.

Informationen zu den möglichen Tag-Werten finden Sie unter System-Tags und Kategorien und System-Tags und Kategorien.

valid_value_ratio
Gibt das Verhältnis der gültigen Werte im Stichprobenumfang an. Zu den ungültigen Werten zählen NULL, leere Zeichenfolgen und Zeichenfolgen mit mehr als 256 Zeichen.

Nutzungshinweise¶

Verwenden Sie eine ALTER TABLE … MODIFY COLUMN … SET TAG-Anweisung, um den Tag-Wert zu aktualisieren.
Um ein Klassifizierungssystem-Tag aus einer Spalte zu entfernen, verwenden Sie eine ALTER TABLE … MODIFY COLUMN … UNSET TAG-Anweisung.

Beispiele¶

Zurückgeben des Ergebnisses der Datenklassifizierung einer Tabelle:

SELECT SYSTEM$GET_CLASSIFICATION_RESULT('hr.tables.empl_info');

Copy