Gérer les annonces avec SQL en tant que consommateur - exemples

Voici quelques exemples de tâches courantes que les consommateurs peuvent effectuer par programmation avec les commandes SQL :

Afficher les annonces disponibles

Affiche les annonces disponibles pour le consommateur exécutant la commande. Pour plus d’informations sur la commande SHOW AVAILABLE LISTINGS, consultez SHOW AVAILABLE LISTINGS.

Description

Remarques

Afficher les annonces disponibles.

Utiliser IS_SHARED_WITH_ME = TRUE pour afficher uniquement les annonces partagées en privé avec le consommateur exécutant la commande. Utiliser IS_IMPORTED = TRUE pour afficher uniquement les annonces importées.

 
SHOW AVAILABLE LISTINGS
Copy

Décrire les annonces disponibles

Après avoir exécuté SHOW AVAILABLE LISTINGS pour identifier les annonces disponibles et les noms des annonces globales, un consommateur peut exécuter DESCRIBE AVAILABLE LISTING pour renvoyer les descriptions des colonnes dans les annonces qui leur sont accessibles. Pour plus d’informations sur la commande DESCRIBE AVAILABLE LISTING, consultez DESCRIBE AVAILABLE LISTING.

Description

Remarques

Décrire les colonnes de l’annonce.

Utiliser listing_global_name pour identifier l’annonce globale spécifique à décrire. Lorsque la colonne is_ready_for_import est TRUE, les données sont déjà présentes dans la région et peuvent être importées immédiatement par le consommateur.

 
DESCRIBE AVAILABLE LISTING < listing_global_name >
Copy

Demander une annonce et interroger automatiquement la disponibilité

Après avoir exécuté SHOW AVAILABLE LISTINGS pour identifier les annonces disponibles, un consommateur peut utiliser la procédure stockée SYSTEM$REQUEST_LISTING_AND_WAIT pour demander une annonce et interroger automatiquement la disponibilité. Un consommateur peut également utiliser cette procédure stockée lorsque la colonne is_ready_for_import est FALSE. Pour plus d’informations sur les procédures stockées SYSTEM$REQUEST_LISTING_AND_WAIT, consultez SYSTEM$REQUEST_LISTING_AND_WAIT.

Description

Remarques

Demander une annonce spécifique et interroger pour vérifier la disponibilité.

<timeout_mins> spécifie la période d’attente d’exécution de l’annonce en minutes. La valeur par défaut est 240 minutes ou 4 heures.

Lorsqu’une annonce demandée devient disponible ou est déjà disponible, le message Success: Listing <listing_global_name> is ready to be imported est renvoyé.

Si la période d’attente est dépassée, le message Error: Timed out waiting for the listing to be available after <timeout_mins> min(s) est renvoyé.

Pour demander une annonce sans attendre la réalisation de l’annonce, entrez 0 (zéro) pour la valeur <timeout_mins>. Lorsque la valeur est 0, le message Success: Listing <listing_global_name> requested successfully, but not waiting to confirm fulfillment est renvoyé.

 
CALL SYSTEM$REQUEST_LISTING_AND_WAIT( ' <listing_global_name> ' [ , <timeout_mins>. ] );
Copy

Créer une base de données à partir d’une annonce

Après avoir demandé une annonce, un consommateur peut utiliser la commande CREATE DATABASE … FROM LISTING … pour créer une base de données à partir d’une annonce. Pour plus d’informations sur la commande CREATE DATABASE … FROM LISTING … , consultez CREATE DATABASE … FROM LISTING ….

Description

Remarques

Créer une base de données à partir d’une annonce.

<name> spécifie l’identificateur de la base de données. Il doit être unique pour votre compte. L’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles. Par exemple, "My object". Les identificateurs entre guillemets doubles sont également sensibles à la casse.

 
CREATE DATABASE <name> FROM LISTING '<listing_global_name>';
Copy
Langage: Français