Catégories :

Fonctions système (Contrôle du système)

SYSTEM$PIPE_FORCE_RESUME

Force un canal mis en pause à reprendre ses activités à l’aide de ALTER PIPE. Cela est nécessaire si le propriétaire du canal transfère la propriété du canal à un autre rôle pendant que celui-ci est suspendu.

L’exécution de cette fonction reprend le canal spécifié. Tous les fichiers soumis au canal pendant sa pause commenceront à se charger dans la table cible. Pour déterminer le nombre de fichiers en file d’attente, interrogez SYSTEM$PIPE_STATUS.

Pour plus d’informations, voir Chargement en continu à l’aide de Snowpipe.

Syntaxe

SYSTEM$PIPE_FORCE_RESUME( '<pipe_name>' )

Arguments

nom_canal

Canal devant reprendre ses activités

Notes sur l’utilisation

  • Seul le propriétaire du canal (c’est-à-dire le rôle dôté du privilège OWNERSHIP sur le canal) ou un rôle avec les autorisations minimales suivantes peuvent appeler cette fonction SQL :

    Privilèges

    Objet

    Remarques

    OPERATE

    Canal

    USAGE

    Définition de la zone de préparation d’un canal

    Zones de préparation externes uniquement

    READ

    Définition de la zone de préparation d’un canal

    Zones de préparation internes uniquement

    SELECT, INSERT

    Table dans la définition du canal

    Les opérations SQL sur les objets de schéma nécessitent également le privilège USAGE sur la base de données et le schéma qui contiennent l’objet.

  • nom_canal est une chaîne, elle doit donc être placée entre guillemets simples :

    • Notez que le nom complet doit être placé entre guillemets simples, y compris la base de données et le schéma (si le nom est complètement qualifié), c’est-à-dire '<bd>.<schéma>.<nom_canal>'.

    • Si le nom du canal est sensible à la casse ou inclut des caractères spéciaux ou des espaces, des guillemets doubles sont nécessaires pour traiter la casse / les caractères. Les guillemets doubles doivent être placés entre guillemets simples, c’est-à-dire '"<nom_canal>"'.

Exemples

Forcez la reprise d’un canal avec un nom ne respectant pas la casse :

SELECT SYSTEM$PIPE_FORCE_RESUME('mydb.myschema.mypipe');

Forcez la reprise d’un canal avec un nom respectant la casse :

SELECT SYSTEM$PIPE_FORCE_RESUME('mydb.myschema."myPipe"');