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_profile_config": {
    "classification_profile_name": "db1.sch.sensitive_data_detection_profile"
  },
  "classification_result": {
    "col1_name": {
      "alternates": [],
      "recommendation": {
        "confidence": "HIGH",
        "coverage": 1,
        "details": [],
        "privacy_category": "QUASI_IDENTIFIER",
        "semantic_category": "DATE_OF_BIRTH",
        "tags": [
          {
            "tag_applied": true,
            "tag_name": "snowflake.core.semantic_category",
            "tag_value": "DATE_OF_BIRTH"
          },
          {
            "tag_applied": true,
            "tag_name": "snowflake.core.privacy_category",
            "tag_value": "QUASI_IDENTIFIER"
          }
        ]
      },
      "valid_value_ratio": 1
    }
  }
}

Copy

Mögliche Felder:

classification_profile_config: Wenn die automatische Klassifizierung konfiguriert ist, enthält sie den vollqualifizierten Namen des Konfigurationsprofils, das zur Erzeugung der Klassifizierungsergebnisse verwendet wurde.
classification_result: Liefert Informationen zu jeder Spalte, die klassifiziert wurde.
object_path_results: Wenn eine Spalte semistrukturierte Daten mit sensiblen Feldern enthält, listet der object_path_results-Schlüssel die Felder auf, die in eine native oder kundenspezifische semantische Kategorie klassifiziert wurden. Weitere Informationen dazu finden Sie unter Ergebnisse für JSON-Spalten.
alternates: Bietet Informationen zu den einzelnen Tags und Werten, die abgesehen vom empfohlenen Tag berücksichtigt werden sollen.
recommendation: Gibt Informationen zu jedem Tag und Wert als primäre Wahl auf der 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
Liefert einen der folgenden Werte: 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
Stellt Felder und Werte bereit, die sich auf die geographische Klassifizierung beziehen. Das Feld semantic_category enthält die semantische Unterkategorie für ein Gebietsschema.

privacy_category
Stellt die Datenschutzkategorie bereit.

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

semantic_category
Liefert die semantische Kategorie. Eine Liste der nativen semantischen Kategorien finden Sie unter Native semantische Kategorien für die Klassifizierung sensibler Daten.

Wenn der Wert MULTIPLE ist, wurden in semistrukturierten Daten sensible Daten gefunden. Überprüfen Sie das Feld object_path_results des Ergebnisobjekts auf eine detaillierte Aufschlüsselung der nativen und kundenspezifischen semantischen Kategorien, die bei der Klassifizierung gefunden wurden. Weitere Informationen dazu finden Sie unter Ergebnisse für JSON-Spalten.

tags
Liefert Informationen über die Tags, die als Ergebnis des Klassifizierungsprozesses auf die Spalte angewendet wurden.

valid_value_ratio
Gibt den Anteil der gültigen Werte bezogen auf die Stichprobengröße an.

Zu den ungültigen Werten bei strukturierten Daten zählen NULL, leere Zeichenfolgen und Zeichenfolgen mit mehr als 256 Zeichen.

Bei semistrukturierten Daten gehören zu den ungültigen Werten NULL und eine leere Zeichenfolge.

Beispiele¶

Gibt das Ergebnis der Klassifizierung sensibler Daten für eine Tabelle zurück:

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

Copy