custom_classifier !ADD_REGEX

Siehe auch:

Verwenden von kundenspezifischen Klassifikatoren zur Implementierung kundenspezifischer semantischer Kategorien

Fügt dem kundenspezifischen Klassifikator Kategorien und einen regulären Ausdruck hinzu, wobei optional ein regulärer Ausdruck für den Spaltennamen und ein Kommentar angegeben werden können.

Syntax

<custom_classifier>!ADD_REGEX(
  SEMANTIC_CATEGORY => '<custom_category>' ,
  PRIVACY_CATEGORY => { 'IDENTIFIER' | 'QUASI-IDENTIFIER' | 'SENSITIVE' } ,
  VALUE_REGEX => '<regular_expression>' ,
  [ COL_NAME_REGEX => <regular_expression> ] ,
  [ DESCRIPTION => <string> ] ,
  [ THRESHOLD => <number> ]
)
Copy

Argumente

Benötigt:

SEMANTIC_CATEGORY => custom_category

Gibt den Namen der kundenspezifischen Kategorie an (d. h. den Informationstyp).

PRIVACY_CATEGORY => { 'IDENTIFIER' | 'QUASI-IDENTIFIER' | 'SENSITIVE' }

Gibt die Sensitivität der Daten an und kann einer der folgenden Werte sein: 'IDENTIFIER', 'QUASI_IDENTIFIER' oder 'SENSITIVE'.

VALUE_REGEX => regular_expression

Gibt den regulären Ausdruck an, der mit den Werten in einer Spalte übereinstimmen soll.

Sie können die Syntax des regulären Ausdrucks testen, indem Sie die Funktion REGEXP_LIKE aufrufen.

Optional:

COL_NAME_REGEX => regular_expression

Gibt den regulären Ausdruck an, der mit dem Namen der Spalte übereinstimmen soll, die Sie klassifizieren möchten.

DESCRIPTION => string

Gibt einen Kommentar an, der die kundenspezifische Kategorie oder den kundenspezifischen Klassifikator beschreibt, der sie implementiert.

THRESHOLD => number

Gibt den Schwellenwert für die Bewertungsregel an. Weitere Informationen dazu finden Sie unter Schwellenwert für kundenspezifische Kategorien.

Der akzeptable Bereich ist größer als 0.0 und kleiner als oder gleich 1.0.

Standard: 0.8.

Ausgabe

Gibt eine Statusmeldung zurück, die die Zuordnung der Kategorie zu dem kundenspezifischen Klassifikator in folgendem Format angibt: classifier_name:category_name.

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Instanzrolle

Objekt

Anmerkungen

custom_classifier !PRIVACY_USER

Die kundenspezifische Klassifizierungsinstanz.

Der Kontorolle, die diese Methode aufruft, muss diese Instanzrolle für den kundenspezifischen Klassifikator zugewiesen sein.

Standardmäßig kann die zur Erstellung der Instanz verwendete Kontorolle diese Methode aufrufen.

Für das Ausführen von Operationen für ein Objekt in einem Schema ist mindestens eine Berechtigung für die übergeordnete Datenbank und mindestens eine Berechtigung für das übergeordnete Schema erforderlich.

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.

Nutzungshinweise

  • Ein mehrfaches Aufrufen dieser Methode ergibt ein additives Ergebnis für die Anzahl der mit der Instanz verbundenen regulären Ausdrücke.

  • Rufen Sie jede Methode in einer separaten SQL-Anweisung auf (keine Methodenverkettung).

  • Bei allen Suchen mit regulären Ausdrücken zu Klassifizierungszwecken wird die Groß- und Kleinschreibung nicht berücksichtigt.

  • Testen Sie den regulären Ausdruck, bevor Sie der kundenspezifischen Klassifizierungsinstanz einen regulären Ausdruck hinzufügen. Verwenden Sie zum Beispiel die Funktion [ NOT ] REGEXP, um sicherzustellen, dass nur Werte, die mit dem Regex übereinstimmen, im Ergebnis zurückgegeben werden:

    SELECT <col_to_classify>
FROM <table_with_col_to_classify>
WHERE <col_to_classify> REGEXP('<regex>');
    Copy

    Weitere Details dazu finden Sie unter Zeichenfolgenfunktionen (reguläre Ausdrücke).

Beispiele

Fügen Sie Kategorien und einen regulären Ausdruck zu der Instanz medical_codes hinzu:

CALL medical_codes!ADD_REGEX(
  SEMANTIC_CATEGORY => 'ICD_10_CODES',
  PRIVACY_CATEGORY => 'IDENTIFIER',
  VALUE_REGEX => '[A-TV-Z][0-9][0-9AB]\.?[0-9A-TV-Z]{0,4}',
  COL_NAME_REGEX => 'ICD.*',
  DESCRIPTION => 'Add a regex to identify ICD-10 medical codes in a column',
  THRESHOLD => 0.8
);
Copy

Rückgabewerte:

+---------------+
|   ADD_REGEX   |
+---------------+
| ICD_10_CODES  |
+---------------+

Erstellen Sie einen benutzerdefinierten Klassifikator, der den Standardschwellenwert verwendet und keinen regulären Ausdruck zum Abgleich von Spaltennamen verwendet:

CALL medical_codes!ADD_REGEX(
  SEMANTIC_CATEGORY => 'ICD_10_CODES',
  PRIVACY_CATEGORY => 'IDENTIFIER',
  VALUE_REGEX => '[A-TV-Z][0-9][0-9AB]\.?[0-9A-TV-Z]{0,4}'
);
Copy