ALTER LISTING

Modifie les propriétés d’une annonce.

Voir aussi :

CREATE LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING, Référence au manifeste d’annonce

Syntaxe

ALTER LISTING [ IF EXISTS ] <name>
  [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> AS '<yaml_manifest_string>'
  [ PUBLISH={ TRUE | FALSE } ]
  [ REVIEW= { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

ALTER LISTING [ IF EXISTS ] <name> RENAME TO <new_name>;

ALTER LISTING [ IF EXISTS ] <name> SET COMMENT = '<string>'
Copy

Paramètres

name

Spécifie l’identificateur (c’est-à-dire le nom) de l’annonce en cours de modification.

yaml_manifest_string

Spécifie le manifeste de format YAML de l’annonce. Voir Référence au manifeste d’annonce pour des détails et des exemples de fichiers de manifeste d’annonce.

Les manifestes sont normalement fournis sous forme de chaînes encadrées de dollars. Pour plus d’informations, voir Constantes de chaînes encadrées de dollars.

RENAME TO new_name

Spécifie le nouvel identificateur de l’annonce, qui doit être unique. Le nouvel identificateur ne peut pas être utilisé si l’identificateur est déjà en place pour une autre annonce.

{ PUBLISH | UNPUBLISH }

Spécifie l’action à effectuer sur l’annonce :

  • PUBLISH Permet de découvrir une annonce qui ne l’était pas auparavant.

    Le fait de spécifier PUBLISH sur une annonce déjà publiée n’a aucun effet.

  • UNPUBLISH Rend une annonce qui pouvait auparavant être découverte impossible à découvrir par de nouveaux consommateurs. Les consommateurs existants peuvent continuer à accéder aux données associées à une annonce non publiée.

    Le fait de spécifier UNPUBLISH sur une annonce non publiée auparavant n’a aucun effet.

Voir aussi Annuler la publication d’une annonce.

SET ...

Spécifie une ou plusieurs propriétés à définir pour l’annonce (séparées par des espaces, des virgules ou de nouvelles lignes).

COMMENT = 'string_literal'

Ajoute un commentaire ou remplace le commentaire existant d’une annonce existante.

PUBLISH = { TRUE | FALSE }

Spécifie la manière dont l’annonce doit être publiée.

Si cette valeur est définie sur TRUE, l’annonce est publiée immédiatement auprès du service Opérations du Marketplace pour examen.

Par défaut : TRUE.

REVIEW =  { TRUE | FALSE }

Spécifie si l’annonce doit ou non être soumise à l’examen du service Opérations du Marketplace.

Par défaut : TRUE.

Des combinaisons de valeurs différentes pour les propriétés PUBLISH et REVIEW entraînent les comportements suivants :

PUBLISH

REVIEW

Comportement

TRUE

TRUE

Demandez un examen, puis publiez immédiatement après approbation.

TRUE

FALSE

Entraîne une erreur. Vous ne pouvez pas publier d’annonce sur le Snowflake Marketplace sans qu’elle ait été examinée.

FALSE

TRUE

Demandez un examen sans publication automatiquement après l’examen.

FALSE

FALSE

Enregistrez votre annonce sous forme de brouillon sans demander d’examen ni de publication.

Notes sur l’utilisation

  • Seules les annonces à l’état de brouillon ou non publiées peuvent être renommées.

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

Un rôle utilisé pour exécuter cette commande SQL doit avoir l’un des privilèges suivants au minimum :

Privilèges

Privilège

Objet

Remarques

OWNERSHIP ou MODIFY

Sur l’annonce en cours de modification.

Privilèges délégués pour configurer l’exécution automatique inter-cloud.

Si la commande ALTER modifie le contenu du manifeste pour l’exécution automatique

Reportez-vous à Autoriser d’autres comptes à configurer l’exécution automatique inter-Cloud.

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

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

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

Exemples

Modifiez l’annonce MY_LISTING de sorte qu’elle utilise un fichier manifeste mis à jour :

ALTER LISTING MYLISTING
AS
  $$
  title: "MyListing"
  subtitle: "Subtitle for MyListing"
  description: "Description or MyListing"
  listing_terms:
    type: "STANDARD"
  targets:
    accounts: ["Org1.Account1"]
  usage_examples:
     - title: "this is a test sql"
       description: "Simple example"
       query: "select *"
  $$
Copy

Modifiez l’annonce MYLISTING en la publiant :

ALTER LISTING MYLISTING PUBLISH;
Copy

Modifiez l’annonce MYLISTING en annulant sa publication.

ALTER LISTING MYLISTING UNPUBLISH;
Copy

Modifiez l’annonce MYLISTING en définissant un nouveau commentaire :

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
Copy
Langage: Français