AI_REDACT¶

Syntax¶

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

Argumente¶

Benötigt:

input

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

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.

Rückgabewerte¶

Generally, a VARCHAR containing placeholder values in place of redacted PII, such as [NAME] where the input text had „John Smith“.

Wenn der Sitzungsparameter AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR auf FALSE und das optionale Argument return_error_details auf FALSE gesetzt ist oder nicht übergeben wird, und die Funktion die Eingabe nicht verarbeiten kann, gibt die Funktion NULL zurück.

Wenn der Sitzungsparameter AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR auf FALSE und das optionale Argument return_error_details auf TRUE gesetzt ist, gibt die Funktion ein OBJECT mit den folgenden Feldern zurück:

• 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.

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.