Kategorien:

Zeichenfolgen- und Binärfunktionen (AI-Funktionen)

AI_REDACT

Erkennt persönlich identifizierbare Informationen (PII) und blendet sie aus unstrukturierten Textdaten aus.

Syntax

Verwenden Sie AI_REDACT zum Erkennen und Ausblenden von PII:

AI_REDACT( <input> [, <categories> ] [, <return_error_details> ] [, <mode> ] )
Copy

Argumente

Benötigt:

input

Ein VARCHAR-Wert, der Textdaten enthält, die möglicherweise persönlich identifizierbare Informationen (PII) enthalten.

Optional:

categories

Ein ARRAY von Zeichenfolgenwerten, die die Typen von PII angeben, die ausgeblendet werden sollen. Wenn die Option nicht angegeben ist, werden alle unterstützten PII-Kategorien ausgeblendet. Eine Liste der unterstützten Kategorien finden Sie unter Erkannte PII-Kategorien.

Das Übergeben einer nicht unterstützten Kategorie führt zu einem Fehler.

return_error_details

Ein BOOLEAN Flag, das angibt, ob im Fehlerfall Fehlerdetails zurückgegeben werden sollen. Wenn sie auf TRUE gesetzt ist, gibt die Funktion ein OBJECT zurück, das den Wert und die Fehlermeldung enthält. Je nachdem, ob die Funktion erfolgreich war oder fehlgeschlagen ist, ist einer dieser beiden NULL.

Erfordert, dass der Sitzungsparameter AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR auf FALSE gesetzt ist.

mode

Ein VARCHAR-Wert, der den Betriebsmodus angibt. Zulässige Werte:

  • redact (Standard): Ersetzt die erkannten PII mit Kategorie-Platzhaltern, wie z. B. [NAME] und [ADDRESS].

  • detect: Gibt ein OBJECT zurück, das ein spans-Array enthält, das den Standort und die Kategorie jeder erkannten PII-Instanz identifiziert, ohne den Text zu unkenntlich zu machen.

Bemerkung

Das mode-Argument unterscheidet nicht zwischen Groß- und Kleinschreibung.

Rückgabewerte

Der Rückgabewert von AI_REDACT hängt vom mode-Argument ab.

Ausblendmodus (Standard)

Gibt einen VARCHAR-Wert zurück, der den Eingabetext mit PII enthält und durch Kategorie-Platzhalter ersetzt wird, wie z. B. [NAME], wobei der Eingabetext „Joan Smith“ lautete.

Erkennungsmodus

Gibt ein OBJECT zurück, das ein spans-Array enthält. Jedes Element in dem Array ist ein OBJECT mit den folgenden Feldern:

  • category: Ein VARCHAR-Wert, der die PII-Kategorie identifiziert (z. B. NAME oder ADDRESS).

  • start: Ein NUMBER-Wert, der den Startindex der PII im Eingabetext identifiziert.

  • end: Ein NUMBER-Wert, der den Endindex der PII im Eingabetext identifiziert.

  • text: Ein VARCHAR-Wert, der den übereinstimmenden PII-Text enthält.

Fehlerverhalten

Wenn AI_REDACT die Eingabe nicht verarbeiten kann, gibt die Funktion standardmäßig einen Fehler zurück. Wenn die Abfrage mehrere Zeilen verarbeitet, schlägt die gesamte Abfrage fehl.

Wenn AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR auf FALSE festgelegt ist, hängt der Rückgabewert bei einem Fehler vom return_error_details-Argument ab. Die folgende Tabelle zeigt den Rückgabewert in Abhängigkeit von dem return_error_details-Argument:

return_error_details

Rückgabewert

Beschreibung
FALSE

Nicht übergeben

NULL

TRUE

OBJECT mit value- und error-Feldern
value: Ein VARCHAR-Wert, der den redigierten Text enthält, oder NULL, wenn ein Fehler aufgetreten ist.

error: Ein VARCHAR -Wert, der bei Auftreten eines Fehlers die Fehlermeldung enthält, oder NULL, wenn die Funktion erfolgreich war.

Weitere Informationen zur Behandlung von Fehlern finden Sie unter Fehler auf Zeilenebene in mehrzeiligen Abfragen behandeln.

Nutzungshinweise

  • Informationen zu Kategorien von PII, die AI_REDACT ausblenden kann, finden Sie unter Erkannte PII-Kategorien.

  • Informationen zu Beschränkungen in der aktuellen Version von AI_REDACT finden Sie unter Einschränkungen.

Beispiele

Siehe Beispiele für die Ausblendung.