ASSOCIATE_SEMANTIC_CATEGORY_TAGS¶

Prend les résultats de la fonction EXTRACT_SEMANTIC_CATEGORIES sur une table/vue et applique les résultats sous forme de balises sur les colonnes prises en charge dans la table/vue.

Avant d’appeler cette procédure stockée, vous devez d’abord exécuter la fonction EXTRACT_SEMANTIC_CATEGORIES sur la table/vue et déterminer si les résultats générés par l’algorithme de classification vous conviennent.

Syntaxe¶

ASSOCIATE_SEMANTIC_CATEGORY_TAGS( '<object_name>' , <category_extraction_result> )

Copy

Arguments¶

object_name

Le nom de la table, de la table externe, de la vue ou de la vue matérialisée contenant les colonnes à classifier. Si une base de données et un schéma ne sont pas utilisés dans la session en cours, le nom doit être entièrement qualifié.

Le nom doit être spécifié exactement comme il est stocké dans la base de données. Si le nom contient des caractères spéciaux, des majuscules ou des espaces vides, il doit être placé d’abord entre guillemets doubles, puis entre guillemets simples.

category_extraction_result

Le résultat de l’exécution de la fonction EXTRACT_SEMANTIC_CATEGORIES sur la même table/vue.

Notes sur l’utilisation¶

Les procédures stockées définies globalement utilisent les droits de l’appelant. Pour plus de détails, voir Understanding Caller’s Rights and Owner’s Rights Stored Procedures.
La fonction applique les balises du système de classification du niveau supérieur des résultats de classification renvoyés par la fonction EXTRACT_SEMANTIC_CATEGORIES. Des valeurs alternatives ne sont pas appliquées.

Si vous voulez appliquer des valeurs alternatives :
- Vous pouvez stocker les résultats de la classification dans une table et modifier les résultats avant de les appliquer ou
- Appliquez les valeurs manuellement en utilisant ALTER TABLE … MODIFY COLUMN … SET TAG.
Pour supprimer une balise du système de classification d’une colonne, utilisez une instruction ALTER TABLE … MODIFY COLUMN … UNSET TAG.
Cette procédure stockée n’est plus mise à jour pour coïncider avec les améliorations supplémentaires apportées à la classification des données.
- Vous pouvez continuer à utiliser cette procédure stockée comme indiqué dans Utilisation de la classification des données avec les APIs standards.
- Cependant, prévoyez de mettre à jour vos workflows comme indiqué dans Classification des données d’utilisation.

Exemples¶

Extraire les catégories sémantiques et de confidentialité pour la table my_db.my_schema.hr_data et appliquer les catégories comme balises pour la table :

USE ROLE data_engineer;

CALL ASSOCIATE_SEMANTIC_CATEGORY_TAGS('mydb.my_schema.hr_data',
                                      EXTRACT_SEMANTIC_CATEGORIES('mydb.my_schema.hr_data'));

Copy

Appliquer les résultats de EXTRACT_SEMANTIC_CATEGORIES qui ont été stockés dans la table classification_results :

USE ROLE data_engineer;

CALL ASSOCIATE_SEMANTIC_CATEGORY_TAGS('mydb.my_schema.hr_data',
                                      (SELECT * FROM classification_results));

Copy

Modifier les résultats de EXTRACT_SEMANTIC_CATEGORIES dans la table classification_results et appliquer les balises :

USE ROLE data_engineer;

UPDATE classification_results SET V =
    OBJECT_INSERT(V,'LNAME',OBJECT_INSERT(
        OBJECT_INSERT(V:LNAME,'semantic_category','NAME',TRUE),
        'privacy_category','IDENTIFIER',TRUE),
        TRUE
        );

CALL ASSOCIATE_SEMANTIC_CATEGORY_TAGS('mydb.my_schema.hr_data',
                                      (SELECT * FROM classification_results));

Copy