custom_classifier !ADD_REGEX

Voir aussi :

Utilisation de classificateurs personnalisés pour la classification des données sensibles

Ajoute des catégories et une expression régulière au classificateur personnalisé, tout en spécifiant éventuellement une expression régulière pour le nom de la colonne et un commentaire.

Syntaxe

<custom_classifier>!ADD_REGEX(
  '<semantic_category>' ,
  '<privacy_category>' ,
  '<value_regex>' ,
  [ <column_name_regex> ] ,
  [ <description> ] ,
  [ <threshold> ]
  )
Copy

Arguments

Obligatoire :

semantic_category

Spécifie l’identificateur (le nom) de la catégorie sémantique.

Pour plus de détails sur les catégories sémantiques, voir Balises système et catégories.

privacy_category

Spécifie l’une des valeurs suivantes : 'IDENTIFIER', 'QUASI_IDENTIFIER', ou 'SENSITIVE'

Pour plus de détails sur les catégories de confidentialité, voir Balises système et catégories.

value_regex

Spécifie l’expression régulière qui doit correspondre aux valeurs d’une colonne.

Vous pouvez tester la syntaxe de l’expression régulière en appelant la fonction REGEXP_LIKE.

Facultatif :

column_name_regex

Spécifie l’expression régulière correspondant au nom de la colonne à classifier.

description

Spécifie un commentaire pour les valeurs que vous ajoutez à l’instance.

threshold

Spécifie la valeur seuil pour la règle de notation.

La plage acceptable est supérieure à 0.0 et inférieure ou égale à 1.0.

Par défaut : 0.8.

Sortie

Renvoie un message de statut indiquant l’association de la catégorie avec le classificateur personnalisé dans ce format : classifier_name:category_name.

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Rôle de l’instance

Objet

Remarques

custom_classifier !PRIVACY_USER

L’instance de classification personnalisée.

Le rôle de compte qui appelle cette méthode doit se voir attribuer ce rôle d’instance sur le classificateur personnalisé.

Par défaut, le rôle de compte utilisé pour créer l’instance peut appeler cette méthode.

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma. Notez qu’un rôle doté d’un privilège quelconque sur un schéma permet à ce rôle de résoudre le schéma. Par exemple, un rôle doté du privilège CREATE sur un schéma peut créer des objets sur ce schéma sans également avoir le privilège USAGE attribué sur ce schéma.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation

  • L’appel multiple de cette méthode donne un résultat additif pour le nombre d’expressions régulières associées à l’instance.

  • Appeler chaque méthode dans une instruction SQL distincte (pas de chaînage de méthodes).

  • Toutes les recherches d’expressions régulières à des fins de classification ne sont pas sensibles à la casse.

  • Testez l’expression régulière avant d’ajouter une expression régulière à l’instance de classification personnalisée. Par exemple, utilisez la fonction [ NOT ] REGEXP pour vous assurer que seules les valeurs correspondant à l’expression régulière sont renvoyées dans le résultat :

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

    Pour plus de détails, voir Fonctions de chaîne (expressions régulières).

Exemples

Ajoutez des catégories et une expression régulière à l’instance medical_codes :

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

Renvoie :

+---------------+
|   ADD_REGEX   |
+---------------+
| ICD_10_CODES  |
+---------------+
Langage: Français