Catégories :

Fonctions de chaîne et fonctions binaires (Fonctions AI)

AI_REDACT

Détecte et masque les informations personnelles identifiables (PII) des données textuelles non structurées.

Syntaxe

Utilisez AI_REDACT pour détecter et masquer des PII :

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

Arguments

Obligatoire :

input

Une valeur VARCHAR qui contient des données de texte pouvant contenir des informations personnelles identifiables (PII).

Facultatif :

categories

Un ARRAY de valeurs de chaînes qui spécifient les types de PII à rédiger. Si non spécifié, toutes les catégories PII prises en charge sont rédigées. Voir Catégories de PII détectées pour une liste des catégories prises en charge.

La transmission d’une catégorie non prise en charge entraîne une erreur.

return_error_details

Un indicateur BOOLEAN qui indique s’il faut renvoyer les détails de l’erreur en cas d’erreur. Lorsqu’il est défini sur TRUE, la fonction renvoie un OBJECT qui contient la valeur et le message d’erreur, dont l’un est NULL selon que la fonction réussit ou échoue.

Nécessite que le paramètre de session AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR soit défini sur FALSE.

mode

Une valeur VARCHAR qui spécifie le mode de fonctionnement. Valeurs acceptées :

  • redact (par défaut) : Remplace les PII détectées par des espaces réservés de catégories, comme [NAME] et [ADDRESS].

  • detect : Renvoie un OBJECT qui contient un tableau spans qui identifie l’emplacement et la catégorie de chaque instance de PII détectée sans masquer le texte.

Note

L’argument mode est insensible à la casse.

Renvoie

La valeur de retour de AI_REDACT dépend de l’argument mode.

Mode de masquage (par défaut)

Renvoie un VARCHAR qui contient le texte d’entrée avec des PII remplacées par des espaces réservés de catégorie, comme [NAME], où le texte d’entrée était « John Smith ».

Mode de détection

Renvoie un OBJECT qui contient un tableau spans. Chaque élément du tableau est un OBJECT avec les champs suivants :

  • category : Une valeur VARCHAR qui identifie la catégorie des PII (par exemple, NAME ou ADDRESS).

  • start : Une valeur NUMBER qui identifie l’index de début des PII dans le texte d’entrée.

  • end : Une valeur NUMBER qui identifie l’index de fin des PII dans le texte d’entrée.

  • text : Une valeur VARCHAR qui contient le texte des PII correspondant.

Comportement d’erreur

Par défaut, si AI_REDACT ne peut pas traiter l’entrée, la fonction renvoie une erreur. Si la requête traite plusieurs lignes, la requête entière échoue.

Lorsque AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR est défini sur FALSE, la valeur de retour sur l’erreur dépend de l’argument return_error_details. La table suivante indique la valeur de retour basée sur l’argument return_error_details :

return_error_details

Valeur de retour

Description
FALSE

Non transmise

NULL

TRUE

OBJECT avec les champs value et error
value : Une valeur VARCHAR qui contient le texte rédigé, ou NULL si une erreur s’est produite.

error : Une valeur VARCHAR qui contient le message d’erreur si une erreur s’est produite, ou NULL si la fonction a fonctionné.

Pour plus d’informations sur le traitement des erreurs, consultez Gérer les erreurs au niveau des lignes dans les requêtes à plusieurs lignes.

Notes sur l’utilisation

Exemples

Voir Exemples de masquage.