Créer et publier une annonce

Cette rubrique contient les procédures de création et de publication d’une annonce en privé ou sur Snowflake Marketplace.

Dans ce chapitre :

Conditions préalables à la création d’une annonce

Pour en savoir plus sur les exigences pour devenir un fournisseur, consultez Utiliser les annonces en tant que fournisseur.

Éléments à prendre en compte pour le partage des annonces dans des comptes situés dans les régions gouvernementales US

Les fournisseurs non gouvernementaux qui souhaitent partager des annonces avec des comptes de consommateurs dans les régions gouvernementales US doivent tenir compte des éléments suivants :

Partager des données ou des applications avec des consommateurs spécifiques à l’aide d’une annonce privée

Vous pouvez créer des annonces gratuites ou payantes pour les partager directement avec des consommateurs spécifiques. Vous pouvez créer une annonce privée pour répondre à une demande provenant d’une annonce à essai limité, ou pour partager des données ou des applications avec un consommateur avec lequel vous entretenez déjà une relation commerciale.

Vous devez connaître l’identificateur du compte d’un consommateur pour partager une annonce avec lui. Voir Recherche de l’organisation et du nom de compte pour un compte.

Note

Votre rôle doit disposer des privilèges requis pour créer une annonce. Voir Privilèges requis pour travailler avec des annonces.

Créer un listing privé gratuit (ou payant hors plateforme)

  1. Effectuez au choix :

  2. Sélectionnez + Create Listing » Specified Customers.

  3. Dans la boîte de dialogue Create Listing, saisissez un nom pour votre listing.

  4. Dans la section Who can discover the listing?, sélectionnez Only specified consumers.

  5. Dans la section What type of listing would you like to publish?, sélectionnez Free (or paid off-platform).

  6. Sélectionnez Next.

  7. Choisissez + Select pour sélectionner les objets à associer à l’annonce.

    • Si vous sélectionnez un ou plusieurs objets de base de données, Snowflake crée un partage sécurisé avec ces objets. Vous pouvez choisir de modifier le nom du partage sécurisé.

    • Si vous sélectionnez un partage sécurisé existant, le nom de ce partage apparaît.

  8. Saisissez une description de votre annonce.

  9. Facultatif : si vous avez plusieurs profils de fournisseur, sélectionnez le profil de fournisseur sous lequel vous souhaitez publier ce listing. Si vous ne sélectionnez pas de profil de fournisseur, Snowflake utilise votre organisation et votre compte par défaut.

  10. Dans la section Consumer Data Sharing Account ID, ajoutez les noms de comptes et d’organisation des consommateurs avec lesquels vous souhaitez partager l’annonce.

  11. Si vous ajoutez un compte de consommateur dans une région qui n’est pas votre région locale, Snowflake active l’exécution automatique pour permettre la réplication des données vers la région distante après qu’un consommateur a obtenu votre listing. Effectuez les étapes supplémentaires suivantes :

    1. Dans la section Auto-fulfillment, entrez une valeur et sélectionnez un intervalle pour spécifier la fréquence de réplication de votre produit de données de votre région vers la région distante.

    2. Si vous n’avez pas défini d’entrepôt par défaut, sélectionnez un entrepôt à utiliser pour l’exécution automatique.

    Pour plus de détails, voir Exécution automatique pour les listings.

  12. Sélectionnez Publish pour publier l’annonce aux consommateurs sélectionnés ou sélectionnez Save Draft pour l’enregistrer comme projet.

Créer une annonce privée payante

  1. Créer une liste.

  2. Configurer l’annonce pour la préparer à la publication.

  3. Soumettez l’annonce pour approbation et la publication.

  4. Connectez-vous à Snowsight.

  5. Sélectionnez + Create Listing » Specified Customers.

  6. Dans la fenêtre Create Listing, saisissez un nom pour votre listing.

  7. Dans la section Who can discover the listing?, sélectionnez Only specified consumers.

  8. Pour facturer le listing, dans la section What type of listing would you like to publish?, sélectionnez Paid on Snowflake.

  9. Sélectionnez Next. Un projet d’annonce est créé.

  10. Configurez les fonctionnalités supplémentaires requises et facultatives. Voir Configurer une annonce.

Créer un essai basé sur l’utilisation

Dans le cadre d’un essai basé sur l’utilisation, vous pouvez proposer un certain nombre de requêtes gratuites que les consommateurs peuvent effectuer sur votre produit de données. Lorsque toutes les requêtes gratuites ont été utilisées, le consommateur doit acheter le produit de données pour effectuer des requêtes supplémentaires.

Pour ajouter un essai à une annonce, celle-ci doit comporter un produit de données et vous devez avoir le rôle ACCOUNTADMIN ou le privilège OWNERSHIP sur l’annonce. Pour en savoir plus sur les privilèges nécessaires à la gestion des annonces, consultez le site Préparer des données pour une annonce.

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data Products > Provider Studio.

  3. Sélectionnez Listings, puis choisissez une annonce existante ou créez-en une nouvelle.

  4. Dans la section Access & Pricing, sélectionnez Edit ou Add à côté de Pricing & Trial.

  5. Sélectionnez Usage-based.

  6. Dans le champ Monthly Fee, entrez un montant mensuel.

  7. En option. Dans la zone Queries, entrez le coût par requête et le nombre de requêtes incluses.

  8. Si vous avez saisi un coût par requête, saisissez le coût mensuel maximum dans le champ Maximum Monthly Charge.

  9. Dans la zone Free Trial, sélectionnez l’un des types d’essai d’utilisation suivants :

    • Limited Usage

    • Limited Time

    • Limited Functionality

    • Limited Functionality & Time

  10. Si vous avez sélectionné Limited Usage, entrez une valeur dans le champ Number of Free Queries During Trial.

  11. Si vous avez sélectionné Limited Time ou Limited Functionality & Time, entrez une valeur dans le champ Length of Trial.

  12. Sélectionnez Save.

Convertir un partage direct en listing privé gratuit (ou payant hors plateforme)

Vous pouvez convertir un partage direct en listing privé gratuit (ou payant hors plateforme) ou en listing publié sur Snowflake Marketplace. Lorsque vous le faites :

  • Les consommateurs actuels conservent l’accès au partage.

  • Vous avez accès aux analyses d’utilisation à partir de la date de publication de l’annonce. Les données historiques d’utilisation ne sont pas disponibles.

  • Vous pouvez utiliser l’exécution automatique pour effectuer des partages avec des consommateurs situés dans des régions distantes si vous n’utilisez pas déjà la réplication pour les objets de votre partage et si votre partage ne contient que des objets pris en charge par l’exécution automatique. Voir Objets pris en charge pour l’exécution automatique.

  • Vous ne pouvez pas convertir votre partage en annonce payante si votre partage a des consommateurs actifs.

Si vous décidez d’utiliser l’exécution automatique pour la prise en charge des consommateurs distants et de vos partages, coordonnez le workflow suivant avec les consommateurs distants de vos données :

  • Après avoir publié l’annonce, indiquez aux consommateurs des régions distantes comment y accéder. Voir Accès à une annonce privée.

  • Une fois que les consommateurs des régions éloignées ont reçu votre annonce, l’exécution automatique réplique les données dans la région distante. Voir les objets pris en charge pour l’exécution automatique.

  • Lorsque l’exécution automatique est terminée, le consommateur reçoit un e-mail l’informant que les données sont disponibles. À ce moment-là, le consommateur doit faire ce qui suit :

    • Supprimez la base de données importée existante créée à partir du partage direct.

    • Obtenez l’annonce et créez une base de données, en utilisant le même nom que la base de données importée depuis le partage direct.

Après avoir configuré votre partage direct en tant qu’annonce, vous pouvez utiliser Provider Studio pour gérer et modifier votre annonce. Voir Modifier les annonces publiées et Surveiller l’utilisation des annonces.

Partager des données ou des applications sur Snowflake Marketplace

Note

Avant de créer et de publier une annonce payante sur Snowflake Marketplace, contactez votre partenaire de développement commercial chez Snowflake. Si vous n’avez pas de partenaire de développement commercial, soumettez un ticket au service Marketplace Operations. Cette étape est nécessaire pour l’approbation de l’annonce.

Note

Votre rôle doit disposer des privilèges requis pour créer une annonce. Voir Privilèges requis pour travailler avec des annonces.

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data Products » Provider Studio.

  3. Sélectionnez + Create Listing » Snowflake Marketplace.

  4. Dans la fenêtre Create Listing, saisissez un nom pour votre listing.

  5. Pour publier le listing sur Snowflake Marketplace, dans la section Who can discover the listing?, sélectionnez Anyone on the Marketplace.

  6. Dans la section What type of listing would you like to publish?, sélectionnez l’une des options suivantes :

    • Free pour proposer un produit de données qui est disponible gratuitement pour les consommateurs.

    • Limited trial pour offrir un essai de votre produit de données, avec un accès illimité au produit de données disponible sur demande.

    • Paid on Snowflake pour facturer votre produit de données sur Snowflake.

  7. Sélectionnez Next. Un projet d’annonce est créé.

  8. Configurer l’annonce pour la préparer à la publication.

  9. Soumettez l’annonce pour approbation et la publication.

Créer une annonce Snowflake Marketplace qui inclut un badge de conformité

Note

À l’heure actuelle, la création d’annonces incluant des badges de conformité ne peut être effectuée qu’au moyen ds APIs d’annonces.

Pour créer une annonce qui comprend des badges de conformité, suivez les étapes ci-dessous :

  1. À l’aide d’un profil approuvé, créez votre manifeste d’annonces.yml.

  2. Dans le fichier manifeste, ajoutez le champ compliance_badges et incluez une ligne pour chaque type de certification, par exemple :

    title: "My listing title"
    subtitle: "My listing subtitle"
    description: "My listing description"
    profile: "MyProfile"
    
    compliance_badges:
    - type: SOC2
      expiry: 12-25-2026
      files:
        - soc2_compliance_verification.pdf
    - type: HIPAA
      expiry: 06-07-2026
      files:
        - hipaa_compliance_verification.pdf
    
    Copy
  3. Installez et configurez SnowSQL.

  4. Pour vous connecter à SnowSQL, exécutez la commande suivante :

    snowsql -c my_example_connection
    
    Copy
  5. Pour créer une base de données, un schéma et une zone de préparation, exécutez les commandes suivantes :

    CREATE DATABASE <db name>;
    CREATE SCHEMA <schema name>;
    CREATE STAGE <stage_name>;
    
    Copy
  6. Pour charger votre fichier manifeste d’annonces à partir de votre espace de stockage local dans la zone de préparation, exécutez la commande suivante :

    PUT file:///<local_path>/manifest.yml @<stage_name>/<prefix>
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    Copy

    Note

    Pour utiliser Snowsight afin de charger des fichiers dans une zone de préparation, suivez les étapes décrite dans Mise de fichiers en zone de préparation à l’aide de Snowsight.

  7. Pour charger les documents de conformité figurant dans le manifeste dans la zone de préparation, exécutez les commandes suivantes :

    PUT file:///<local_path>/soc2_compliance_verification.pdf @<stage_name>/<prefix>
    PUT file:///<local_path>/hipaa_compliance_verification.pdf @<stage_name>/<prefix>
    PUT file:///<local_path>/sample.pdf @<stage_name>/<prefix>
      SOURCE_COMPRESSION=None
      AUTO_COMPRESSION=False
      OVERWRITE=True;
    
    Copy
  8. Pour vérifier que les fichiers ont bien été chargés et que les noms sont corrects, exécutez la commande suivante :

    LIST @<stage_name>/<prefix>;
    
    Copy
  9. Pour créer une annonce en utilisant le fichier manifeste que vous avez chargé dans la zone de préparation, utilisez CREATE LISTING, par exemple :

    CREATE EXTERNAL LISTING <listing_name>
      APPLICATION PACKAGE <app package name>
      FROM @<staging_name>/<prefix>
      REVIEW = True
      PUBLISH = True;
    
    Copy

Après avoir ajouté un badge de conformité à une annonce, vous pouvez vérifier que le badge a été ajouté correctement en utilisant SQL.

Pour vous assurer que le badge de conformité a été ajouté à une annonce, procédez comme suit :

  1. Exécutez la commande suivante :

    DESCRIBE LISTING <listing_name> REVISION = DRAFT;
    
    Copy
  2. Dans la sortie, vérifiez la colonne manifest.yml pour la section compliance_badges.

Configurer une annonce

Vous devez fournir des détails supplémentaires pour les annonces privées payantes et toute annonce proposée sur Snowflake Marketplace avant de pouvoir soumettre votre annonce pour approbation ou de la publier pour des consommateurs spécifiques.

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data Products » Provider Studio.

  3. Sélectionnez l’onglet Listings puis sélectionnez l’ébauche de l’annonce que vous souhaitez publier.

  4. Sélectionnez Add à côté de chaque section qui apparaît sur la page et fournissez les informations requises.

    Au fur et à mesure que vous fournissez des informations pour chaque section, reportez-vous à Configurer des annonces pour obtenir des informations sur chaque champ. Les propriétés spécifiques que vous pouvez modifier dépendent du type d’annonce que vous créez.

Publier une annonce

Après avoir créé et configuré une annonce, vous pouvez publier une annonce.

Les procédures spécifiques de publication d’un listing dépendent du fait que vous publiiez un listing privé gratuit (ou payant hors plateforme), que vous proposiez un listing privé payant ou que vous proposiez n’importe quel listing sur Snowflake Marketplace :

Pour publier une annonce, vous devez utiliser le rôle ACCOUNTADMIN ou un autre rôle avec le privilège OWNERSHIP pour l’annonce que vous souhaitez publier.

Lorsque vous publiez une annonce, elle est visible par les consommateurs dans toutes les régions actuelles et futures de Marketplace, mais les consommateurs ne peuvent obtenir, acheter ou demander votre produit que dans les régions que vous sélectionnez.

Publier une annonce à l’intention de consommateurs spécifiques

Pour partager votre annonce privée avec des comptes de consommateurs spécifiques, vous devez publier l’annonce sur ces comptes. Les annonces privées n’apparaissent pas sur Snowflake Marketplace.

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data Products » Provider Studio.

  3. Sélectionnez l’onglet Listings puis sélectionnez l’ébauche de l’annonce que vous souhaitez publier.

  4. Sélectionnez Publish.

Une fois que vous avez publié l’annonce, celle-ci est accessible aux consommateurs sélectionnés à partir de Private Sharing. Voir Accès et installation des annonces en tant que consommateur.

Note

Une fois que vous avez publié une annonce privée, vous ne pouvez pas modifier le partage associé à l’annonce.

Publier une annonce sur Snowflake Marketplace

Chaque annonce dans Snowflake Marketplace doit passer par le processus de révision et d’approbation. Lorsqu’une annonce est approuvée, elle peut être publiée dans Snowflake Marketplace. Si une annonce a été rejetée, consultez les commentaires, mettez à jour l’annonce et soumettez-la à nouveau pour approbation.

Soumettre votre annonce pour approbation

Avant de pouvoir publier une annonce sur Snowflake Marketplace, vous devez soumettre l’annonce à Snowflake en vue de son approbation.

Si vous voulez soumettre votre annonce pour approbation mais que l’option Submit for Approval est désactivée, vérifiez ce qui suit :

  • Vous avez terminé les étapes de configuration de l’annonce. Voir Configurer une annonce.

  • Vous êtes le ACCOUNTADMIN ou avez le privilège OWNERSHIP pour le produit de données attaché à l’annonce.

  • Toutes les requêtes de l’échantillon SQL jointes à l’annonce passent la validation.

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data Products » Provider Studio.

  3. Sélectionnez l’onglet Listings puis sélectionnez l’ébauche de l’annonce que vous souhaitez soumettre pour approbation.

  4. Sélectionnez Submit for Approval.

  5. Une fois l’annonce examinée par Snowflake, l’état passe à Approved ou Denied.

    Si l’annonce a été refusée, mettez-la à jour en fonction du retour fourni dans les commentaires et soumettez-la de nouveau pour approbation.

    Lorsqu’une annonce est approuvée ou refusée, une notification par e-mail est envoyée aux adresses e-mail Business Contact et Technical Contact et présentes dans le profil du fournisseur associé à l’annonce.

Publier votre annonce

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data Products » Provider Studio.

  3. Sélectionnez l’onglet Listings, puis sélectionnez l’annonce approuvée que vous souhaitez publier.

  4. Sélectionnez Publish.

Après avoir publié votre annonce Snowflake Marketplace pour la première fois, les modifications ultérieures de l’annonce qui nécessitent l’approbation de Snowflake sont publiées automatiquement après approbation. Pour empêcher la publication automatique de votre annonce, voir Désactiver la publication automatique.

Lorsque vous publiez une annonce, celle-ci est visible par les consommateurs de toutes les régions actuelles et futures de Snowflake Marketplace. Les consommateurs ne peuvent obtenir, acheter ou demander votre produit que dans les régions que vous sélectionnez. Voir Exécution automatique pour les listings pour plus d’informations sur la disponibilité des régions.

Après avoir publié votre annonce Snowflake Marketplace vous pouvez définir un lien de référence pour l’annonce. Les liens de référence vous permettent d’offrir aux consommateurs un lien direct vers votre annonce.

Désactiver la publication automatique

Après la publication d’une annonce, vous pouvez désactiver la publication automatique pour les modifications futures de l’annonce.

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data Products » Provider Studio.

  3. Sélectionnez l’onglet Listings, puis sélectionnez l’annonce approuvée pour laquelle vous souhaitez désactiver la publication automatique.

  4. Sur la page des détails de l’annonce, sélectionnez Settings.

  5. Dans la sous-section Publishing de la section Listing Settings, sélectionnez Edit Publishing.

  6. Dans la fenêtre Publish Setting, sélectionnez Manual.

  7. Sélectionnez Save.

La liste ne fait plus l’objet d’une publication automatique. Désormais, lorsque vous apportez des modifications à votre annonce, vous devez publier manuellement l’annonce. Voir Publier votre annonce.

Joindre un notebook à une annonce Snowflake Marketplace

Les fournisseurs peuvent ajouter un notebook à une annonce pour montrer aux consommateurs potentiels comment ils peuvent tirer parti d’un produit de données. Les annonces seront disponibles sur le Snowflake Marketplace public, l’Internal Marketplace, ou sous forme d’annonces privées destinées à un ensemble restreint de consommateurs.

Un fournisseur peut joindre à une annonce un notebook qui a été entièrement exécuté avec des résultats. Les résultats peuvent inclure des sorties tabulaires ou des visualisations permettant de décrire la valeur des produits de données d’une annonce. Les fournisseurs peuvent inclure dans le notebook des exemples basés à la fois sur Python et sur SQL, et y ajouter des explications Markdown claires pour guider les consommateurs.

Note

Les notebooks associés à une annonce sont accessibles en lecture seule et ne peuvent pas être clonés, téléchargés ni modifiés par le consommateur.

Pour joindre un notebook à une annonce, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez Projects » Notebooks dans le menu de navigation gauche.

  3. Créez un notebook.

  4. Dans chaque cellule du notebook, sélectionnez Run all ou Run pour générer des résultats. Assurez-vous d’effectuer l’exécution dans chaque cellule.

  5. Pour vérifier que le notebook fonctionne correctement, recherchez l’indicateur d’état d’exécution vert.

  6. Pour mettre fin à votre session Notebooks, cliquez sur le menu déroulant Active, puis sélectionnez End session.

  7. Sélectionnez Data Products » Provider Studio. Vous pouvez joindre un notebook à tous les types d’annonces.

  8. Créez une nouvelle annonce ou choisissez une annonce existante.

  9. Sélectionnez + Add data product.

  10. Choisissez + Select.

  11. Dans la section Quick Start Examples, sélectionnez Add Notebook.

  12. Sélectionnez le notebook à joindre. Vous pouvez utiliser la fonction de recherche pour trouver un notebook spécifique.

  13. Sélectionnez Save.

  14. Pour publier l’annonce auprès des consommateurs souhaités, sélectionnez Publish.

Note

Pour mettre à jour le contenu du notebook après l’avoir joint à une annonce, vous devez supprimer le notebook de l’annonce, puis le joindre à nouveau.

Supprimer un notebook d’une annonce

  1. Sélectionnez Data Products » Provider Studio.

  2. Dans la section Quick Start Examples, sélectionnez le notebook à supprimer.

  3. Sélectionnez Remove Notebook.

Note

Si vous perdez la propriété du notebook, ou si vous le supprimez ou le retirez de vos ressources partagées, une copie reste jointe à l’annonce.

Limitations

  • Les fournisseurs ne peuvent joindre qu’un seul notebook à une annonce, et le fournisseur doit avoir les privilèges OWNERSHIP sur le notebook.

  • Les consommateurs ne peuvent voir que le notebook et ses résultats dans les annonces.

  • Les modifications apportées au notebook ne sont pas automatiquement ajoutées à l’annonce. Pour afficher les dernières modifications, vous devez supprimer le notebook, puis le joindre de nouveau.