SYSTEM$CANCEL_CLASSIFY_SCHEMA¶

Planifie l’annulation du processus de classification pour les tables du schéma spécifié. Vous pouvez annuler le processus de classification des tables auxquelles le rôle utilisé pour appeler cette procédure stockée peut accéder.

Une table dont le processus de classification est annulé n’est pas classée tant que vous ne la classez pas à nouveau.

Syntaxe¶

SYSTEM$CANCEL_CLASSIFY_SCHEMA( '<object_name>' )

Copy

Arguments¶

object_name

Nom du schéma contenant les tables dont le processus de classification doit être annulé. 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.

Renvoie¶

La procédure stockée renvoie un objet JSON dans le format suivant, en fonction du nom du schéma spécifié :

Si vous appelez SYSTEM$CLASSIFY_SCHEMA pour préparer la classification et appelez ensuite SYSTEM$CANCEL_CLASSIFY_SCHEMA avec le même nom de schéma pour annuler le processus de classification, la sortie est la suivante :

{
  "failed": [],
  "succeeded": [
    {
      "message": "Classification Cancelled for table [T1].",
      "table_name": "T1"
    },
    {
      "message": "Classification Cancelled for table [T2].",
      "table_name": "T2"
    },
    ...
    }
  ]
}

Copy

Si vous appelez SYSTEM$CANCEL_CLASSIFY_SCHEMA et le schéma spécifié n’est pas préparé pour la classification, la sortie est la suivante :

{
  "failed": [
    {
      "message": "Unable to cancel classification for table [T1] since its already complete.",
      "table_name": "T1"
    },
    {
      "message": "Unable to cancel classification for table [T2] since its already complete.",
      "table_name": "T2"
    },
    ...
  ],
  "succeeded": []
}

Copy

Où :

failed: Spécifie une raison pour laquelle le processus d’annulation ne peut pas être effectué pour la table spécifiée.
succeeded: Confirme que le processus d’annulation est planifié pour la table spécifiée.

Notes sur l’utilisation¶

Le processus d’annulation peut prendre un peu de temps (quelques secondes). Cette opération est analogue à l”annulation d’une requête.
Le nom du schéma spécifié peut contenir jusqu’à 1 000 objets de table. Si le schéma contient plus de 1 000 objets de table, Snowflake renvoie un message d’erreur.
Les procédures stockées fournies par Snowflake utilisent les droits de l’appelant. Pour plus de détails, voir Présentation des procédures stockées des droits de l’appelant et des droits du propriétaire.

Exemples¶

Annule la classification des tables dans le schéma :

CALL SYSTEM$CANCEL_CLASSIFY_SCHEMA('hr.tables');

Copy