Configurer des annonces¶
Lorsque vous créez une annonce, vous devez remplir des champs supplémentaires pour votre annonce avant de la mettre à la disposition des consommateurs.
Selon la manière dont vous mettez votre annonce à disposition et dont les consommateurs accèdent à votre produit de données, certaines sections ou certains champs peuvent être facultatifs.
Après avoir configuré votre annonce, publiez-la auprès des consommateurs. Voir Publier une annonce.
Dans ce chapitre :
Informations de base¶
Complétez les informations de base concernant votre annonce. Le tableau suivant décrit les champs de la section Basic Information :
Nom du champ |
Description |
Exemple |
---|---|---|
Title |
Titre de l’annonce. Lorsque les consommateurs consultent votre annonce, le titre apparaît sous le nom de votre entreprise. Le titre doit présenter les caractéristiques suivantes pour être approuvé :
|
Météo historique par code postal. |
Subtitle |
Fournit une explication brève et informative de votre produit de données, visible par les consommateurs. Le sous-titre ne peut pas dépasser 100 caractères. Utilisez la casse de la phrase pour le sous-titre et ne répétez pas le titre. Cette option n’est pas disponible pour les annonces privées. |
Données météorologiques historiques par emplacement. |
Category |
Les catégories aident les consommateurs à trouver vos données ou votre application sur Snowflake Marketplace. Sélectionnez la catégorie souhaitée dans la liste déroulante des valeurs disponibles. Vous ne pouvez choisir qu’une seule catégorie. Cette option n’est pas disponible pour les annonces privées. |
Environnement |
Terms of Service |
Spécifie un lien vers les conditions d’annonce - l’accord de service de l’annonce. Les consommateurs doivent accepter les conditions d’annonce avant de pouvoir accéder à l’annonce. Les conditions d’annonce sont obligatoires pour toutes les annonces. Sélectionnez l’un des éléments suivants :
|
Custom, |
Détails¶
Complétez les détails supplémentaires de votre annonce.
Note
Cette section est facultative pour les annonces privées.
Le tableau suivant décrit les champs disponibles dans la section Details :
Nom du champ |
Description |
Exemple |
---|---|---|
Description |
Description du produit de données partagé dans l’annonce. La description aide les consommateurs à comprendre ce que contient votre produit de données. Saisissez une description entre 250 et 6 000 caractères, avec des sauts de ligne entre les paragraphes. Utilisez des tirets à la place des puces. La description doit comprendre un paragraphe d’introduction contenant des informations sur le produit de données, telles que la portée de l’ensemble de données. Pour les annonces qui comprennent des services ou des fonctions sécurisées, la description doit inclure le workflow prévu pour que les consommateurs accèdent à vos services ou à vos fonctions sécurisées. La description peut également inclure les sources de données pour votre annonce, ou des informations supplémentaires qui ne sont pas couvertes par d’autres champs. |
ACME est le premier fournisseur d’avertissements météorologiques personnalisés et précis aux grandes entreprises, ainsi qu’une source d’informations vitales pour les prévisions météorologiques, les données et les services de conseil météorologique dans le monde entier. Ces annonces fournissent des données météorologiques historiques pour les codes postaux US qui peuvent être utilisées pour améliorer davantage vos données existantes afin de fournir des analyses plus approfondies. Workflow prévu :
|
Link to Documentation |
Un lien vers une page du site Web avec une documentation plus détaillée pour l’annonce. La documentation doit être claire et faire référence aux bons objets de schéma présents dans l”Snowflake Native App ou le partage de données associé à l’annonce. Le lien doit être accessible sur Internet et ne doit pas nécessiter d’authentification pour y accéder. |
|
Link to Video |
Un lien vers une vidéo non répertoriée ou publique YouTube pour l’annonce. Les vidéos privées ne sont pas prises en charge. Les vignettes vidéo sont affichées sur la page des détails de l’annonce et les vidéos ne sont pas lues automatiquement. Astuce Lorsque vous créez une vidéo à afficher sur la page des détails d’une annonce, gardez les points suivants à l’esprit :
|
Produit de données¶
Configurez le produit de données pour votre annonce, soit un partage sécurisé, soit une Snowflake Native App.
Vous pouvez sélectionner des objets et demander à Snowflake de créer un partage sécurisé ou d’ajouter un partage que vous avez déjà créé. Consultez Préparer les partages pour votre annonce pour des conseils sur la création de partages pour les annonces payantes.
Lorsque vous ajoutez un produit de données à votre annonce, tenez compte des éléments suivants :
Les partages sécurisés ne peuvent être rattachés qu’à une seule annonce.
Après la publication de l’annonce, vous ne pouvez pas joindre un autre partage.
Vous ne pouvez voir que les partages qui appartiennent à votre rôle actuel.
Le produit de donnés doit être légalement partageable (vous devez être propriétaire des données ou avoir le droit de les partager).
Tant qu’une annonce n’est pas publiée, elle ne peut être associée qu’à un partage du compte local/primaire. Une fois l’annonce publiée, elle peut être associée à un partage dans les régions supplémentaires que vous avez sélectionnées.
Le tableau suivant décrit les champs disponibles dans la section Data Product :
Nom du champ |
Description |
---|---|
Objets de base de données ou partage sécurisé |
Les données que vous souhaitez partager dans le cadre de l’annonce. |
Produit de données : dictionnaire de données¶
Après avoir ajouté un produit de données à votre annonce, vous pouvez ajouter un dictionnaire de données. Un dictionnaire de données apporte aux consommateurs des informations sur le contenu et la structure d’une annonce gratuite ou payante proposée sur Snowflake Marketplace avant d’installer le produit de données dans leur compte.
Note
Cette section est facultative pour les annonces privées.
À propos des dictionnaires de données¶
Vous pouvez utiliser un dictionnaire de données pour rendre le contenu de votre annonce visible aux consommateurs. Un dictionnaire de données est généré pour les tables et les vues d’une annonce. Les annonces peuvent également inclure une avant-première des données, appelée « Avant-première des données du dictionnaire de données ».
Vos données sont visibles de deux manières :
Les objets à la une permettent au consommateur de voir rapidement le contenu de l’objet. Vous pouvez sélectionner jusqu’à cinq objets de base de données parmi les plus importants de l’annonce.
Tous les objets : permet au consommateur de voir tous les objets d’une annonce. Elle est générée automatiquement lorsque vous publiez une annonce.
L’Avant-première des données du dictionnaire de données permet aux fournisseurs et aux consommateurs de prévisualiser les données des tables et des vues associées aux annonces.
Les avant-première fournissent un échantillon représentatif des données permettant :
Aux fournisseurs de voir exactement quelles données seront disponibles dans une avant-première.
Aux consommateurs de déterminer si une annonce contient les données qu’ils recherchent.
Note
Les données d’une annonce sont automatiquement mises à disposition pour l’avant-première. Les fournisseurs n’ont rien à faire de particulier pour activer l’avant-première.
Mettre en place un dictionnaire de données pour votre annonce¶
Avant de pouvoir ajouter un dictionnaire de données, vous devez ajouter un produit de données à l’annonce. Toutes les annonces proposées sur Snowflake Marketplace doivent inclure un dictionnaire de données.
Pour configurer un dictionnaire de données, procédez comme suit :
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Data Products » Provider Studio » Listings.
Recherchez et sélectionnez l’annonce dans laquelle vous souhaitez ajouter un dictionnaire de données.
Sélectionnez Save and Create Data Dictionary.
Note
En enregistrant ce partage, vous acceptez que Snowflake soit autorisée à créer un dictionnaire de données et une avant-première associée pour le partage et à l’afficher aux consommateurs lors de la publication de l’annonce.
Notez que les Avant-première des données du dictionnaire de données sont automatiquement mises à jour lorsque les données sous-jacentes sont modifiées.
Si votre produit de données contient des PII ou d’autres données à caractère personnel, masquez ces colonnes en tant que telles. Pour plus d’informations, y compris des instructions sur la manière de masquer des PII et d’autres données à caractère personnel, voir Masquer PII et d’autres données dans les aperçus de données.
Après avoir enregistré l’annonce, le dictionnaire de données s’affiche, répertoriant toutes les tables, vues et fonctions de l’annonce.
Recherchez ou sélectionnez un objet que vous souhaitez inclure en tant qu’objet en fonction, puis sélectionnez Add to featured.
Vous pouvez également répéter cette étape pour ajouter d’autres objets en fonction. Vous pouvez avoir jusqu’à cinq objets en fonction dans une annonce.
Sélectionnez Save.
Vous pouvez modifier les descriptions des colonnes des tables dans Provider Studio ou vous pouvez utiliser SQL. Utilisez le paramètre COMMENT dans les commandes CREATE <object> and ALTER <object> ou dans la commande COMMENT pour ajouter un commentaire décrivant un objet ou des colonnes de table individuelles.
Masquer PII et d’autres données dans les aperçus de données¶
Snowflake exécute périodiquement la Classification des données sur les Data Previews pour identifier et masquer toute colonne avec une forte probabilité de contenir des PII (Informations personnelles identifiables) ou d’autres données personnelles. Les données personnelles comprennent les informations relatives à une personne identifiée ou identifiable, telles que :
Nom, âge, e-mail ou adresse postale
Informations sur l’éducation ou l’emploi
Données de localisation ou activité de l’appareil
Dossiers clients ou informations de compte
Une fois que Snowflake identifie et masque une colonne de PII colonne, un e-mail est envoyé au contact technique répertorié dans le profil du fournisseur pour examiner les détails. À tout moment, vous pouvez sélectionner ou désélectionner manuellement les colonnes PII dans le Data Preview.
Pour voir ou modifier les résultats PII de classification, procédez comme suit :
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Data Products » Provider Studio.
Sélectionner Listings depuis la navigation supérieure. Si vous n’avez pas encore créé d’annonce, créez-en une comme décrit dans Créer et publier une annonce.
Sélectionnez l’annonce à consulter.
Sous Data Dictionary, sélectionnez Edit.
Sélectionnez le tableau ou la vue à consulter.
Revoir les résultats de classification. Colonnes contenant des PII ou toute autre donnée personnelle sont classées comme « Contient des PII ».
Sélectionnez l’onglet Data Preview pour prévisualiser le contenu de l’objet, qui peut inclure des données masquées.
Si une colonne n’est pas identifiée correctement :
Si une colonne est identifiée par erreur comme contenant des PII, décochez la case à gauche de la colonne Name pour garantir que les données de cette colonne sont démasquées dans le Data Preview.
Si une colonne contient des PII mais n’a pas été identifiée comme tel, cochez la case à gauche de la colonne Name pour garantir que les données de cette colonne sont masquées dans le Data Preview.
Sélectionnez Save.
Si vous êtes d’accord avec la classification des données, sélectionnez Save.
Note
Le contenu de l’avant-première des données est généré lorsqu’un dictionnaire de données est activé pour une annonce. Il se peut que les données d’avant-première des tables et vues individuelles ne soient pas immédiatement disponibles pendant la génération des données.
Note
Cela peut prendre jusqu’à 3 à 4 heures pour que les colonnes sélectionnées comme PII dans Provider Studio s’affichent masquées sur l’annonce visible par le consommateur.
Actualisation de l’avant-première des données¶
Si vous ajoutez ou retirez des objets dans votre annonce, ou si vous modifiez le schéma d’un objet, l’avant-première des données associée sera actualisée, si cette fonction est activée. La mise à jour des données d’un objet n’entraîne pas l’actualisation de l’avant-première des données.
Note
Les avant-première des données sont automatiquement actualisées à des intervalles d’environ quelques heures. Il se peut que vous ne voyiez pas l’avant-première actualisée immédiatement après l’ajout ou le retrait d’objets ou la mise à jour de schémas. Si les données des objets existants (par exemple, les lignes d’une table) sont mises à jour, mais qu’aucun changement de schéma ni aucun nouvel objet n’est ajouté, l’aperçu des données ne sera pas actualisé immédiatement. Dans ce cas, l’aperçu des données ne sera mis à jour que lors de la prochaine actualisation bimensuelle.
Produit de données - Attributs¶
Après avoir spécifié un produit de données, vous pouvez définir des attributs supplémentaires pour une annonce.
Note
Cette section est facultative pour les annonces privées.
Le tableau suivant décrit les champs disponibles dans la section Attributes pour un produit de données :
Nom du champ |
Description |
---|---|
Update Frequency |
Fréquence à laquelle votre produit de données est mis à jour dans Snowflake. Si votre produit de données est mis à jour à différentes fréquences, choisissez la fréquence de mise à jour la plus élevée pour votre produit de données. |
Geographic Coverage |
Sélectionnez une ou plusieurs régions géographiques couvertes par votre produit de données. Le cas échéant, choisissez des pays ou des États américains spécifiques. |
Geographic Granularity |
Si vous indiquez que la couverture géographique de votre jeu de données est mondiale ou qu’elle comprend plusieurs États ou pays, sélectionnez une granularité pour le produit de données. Vous ne pouvez choisir qu’une seule option, alors sélectionnez l’option la plus granulaire disponible dans votre produit de données. |
Time Range |
Spécifiez la période couverte par votre produit de données. Vous pouvez spécifier des dates personnalisées sous la forme d’un intervalle de temps fixe (2020-01-01 - 2021-01-01) ou d’un intervalle de temps dynamique (X prochains/derniers jours, semaines, mois ou années). |
Timestamp Granularity |
Si vous spécifiez un intervalle de temps, sélectionnez une granularité d’horodatage pour le produit de données. Vous ne pouvez choisir qu’une seule option, c’est pourquoi vous devez sélectionner le type d’horodatage le plus granulaire dans votre produit de données. |
Additional attributes (facultatif) |
Toute information supplémentaire que vous souhaitez communiquer à vos consommateurs. Vous pouvez inclure jusqu’à quatre attributs supplémentaires des données. Utilisez entre deux à cinq mots pour chaque attribut afin de maximiser la lisibilité. Chaque attribut doit comporter moins de 80 caractères. |
Accès et tarifs - accès aux annonces¶
Pour les annonces proposées sur Snowflake Marketplace, vous pouvez consulter l” Listing Access d’une annonce et le modifier si l’annonce est encore en stade de projet.
L’accès à l’annonce contrôle la manière dont les consommateurs peuvent accéder à votre produit de données. Voir Options d’accès aux annonces pour plus de détails.
Accès et tarifs - essai¶
Ajouter un essai pour une annonce à essai limité offerte sur Snowflake Marketplace. Pour ajouter un essai à une annonce payante, consultez Accès et tarifs - tarifs et essai.
Note
Cette option est requise pour les annonces à essai limité.
Le tableau suivant décrit les champs disponibles dans la section Trial :
Champ |
Description |
---|---|
Trial Type |
Choisissez le type d’essai à proposer :
Si votre annonce comporte un paquet d’application comme produit de données, vous pouvez également faire votre choix parmi deux autres types d’essai :
Prudence Vous devez limiter les fonctionnalités de votre application via la fonction système SYSTEM$IS_LISTING_TRIAL. Si vous sélectionnez une version d’essai avec des fonctionnalités limitées et si votre paquet d’application n’est pas configuré pour limiter les fonctionnalités dans le contenu de données partagées ou la logique d’application, votre application fournira les fonctionnalités complètes aux clients de la version d’essai. Voir Limiter les fonctionnalités de votre Snowflake Native App pour les consommateurs en version d’essai pour des informations détaillées sur la configuration complète des versions d’essai offrant des fonctionnalités limitées. |
Accès et tarifs - tarifs et essai¶
Ajoutez le plan tarifaire et l’essai pour votre annonce payante dans cette section.
Cette section est obligatoire pour les annonces payantes sur Snowflake Marketplace, mais les essais sont facultatifs pour les annonces privées payantes.
Note
Seuls les administrateurs de compte (utilisateurs ayant le rôle ACCOUNTADMIN) ou le propriétaire de l’annonce (un rôle avec le privilège OWNERSHIP sur l’annonce) peuvent remplir cette section.
Le tableau suivant décrit les champs disponibles dans la section Trial & Pricing :
Champ |
Description |
---|---|
Pricing Plan |
Choisissez le plan tarifaire de l’annonce. Voir Modèles de tarification des annonces payantes. Les prix sont exprimés en dollars US uniquement. |
Free Trial |
Choisissez le type d’essai pour l’annonce :
|
Besoins commerciaux¶
Ajoutez les besoins commerciaux pour lesquels votre produit de données peut aider les consommateurs.
Note
Cette section est facultative pour les annonces privées.
Le tableau suivant décrit les champs disponibles dans la section Business Needs :
Nom du champ |
Description |
Exemple |
---|---|---|
Business Need |
Aidez les consommateurs à trouver votre annonce sur Snowflake Marketplace en spécifiant les besoins commerciaux pertinents auxquels répond votre produit de données. Vous pouvez sélectionner jusqu’à six besoins commerciaux pour votre annonce. Si vous ne voyez pas de besoin commercial pertinent dans la liste déroulante, vous pouvez en créer un personnalisé en utilisant entre deux et quatre mots. Les consommateurs ne peuvent pas filtrer par besoins commerciaux personnalisés sur Snowflake Marketplace. Vous pouvez modifier la liste des régions disponibles à tout moment sans renvoyer l’annonce en vue de son approbation. |
Enrichissement des données d’emplacement |
Description |
Description de la manière dont votre annonce répond aux besoins commerciaux sélectionnés, à l’aide d’un exemple spécifique à un cas d’utilisation client ou à un besoin commercial. Ajoutez une description unique pour chaque besoin commercial. |
Enrichissement des données d’emplacement : identifiez tous les codes postaux associés à un comté donné, à un secteur de recensement ou à une zone statistique de base. |
Exemple de requêtes SQL¶
Vous pouvez spécifier des exemples de requêtes SQL valides que les consommateurs peuvent utiliser pour exploiter au mieux votre produit de données et en retirer de la valeur, ou au moins vérifier que votre produit de données a été installé avec succès dans leur compte Snowflake.
Note
Au moins une requête SQL valide est nécessaire pour que vous puissiez publier une annonce sur Snowflake Marketplace. Il est recommandé d’inclure trois à quatre exemples de requêtes.
Les requêtes SQL sont facultatives lors de la publication d’annonces privées.
L’échantillon SQL a les exigences suivantes :
La requête doit renvoyer au moins une ligne.
La requête doit faire référence à des objets qui sont explicitement dans le partage.
Les objets doivent être qualifiés à l’aide de
SCHEMA.OBJECT
. Ne pas inclure le nom de la base de données. Par exemple,EXAMPLE_SCHEMA.TABLE_A
.
Sélectionnez Add pour ajouter une requête SQL. Le tableau suivant décrit les champs disponibles dans la section Sample SQL Queries :
Nom du champ |
Description |
Exemple |
---|---|---|
Title |
Titre descriptif de la requête pour aider les consommateurs à comprendre comment utiliser le produit de données. |
Déterminez si un événement en plein air pourrait être affecté par la pluie. |
Description (Optional) |
Description de l’exemple qui lie le titre à un cas d’utilisation spécifique du produit de données. La description est automatiquement chargée en tant que commentaire lorsque les consommateurs exécutent l’exemple de requête après avoir installé votre produit de données. Vous pouvez également inclure des instructions supplémentaires, telles que le nom du schéma, des exemples de tables ou des champs. Utilisez le format <schéma>.<table> pour référencer les tables et les vues dans votre SQL. N’incluez pas le nom de la base de données dans la requête, car les consommateurs créent des noms de base de données personnalisés lorsqu’ils obtiennent votre annonce. |
Si vous organisez un événement en plein air dans les 7 prochains jours, utilisez nos données prévisionnelles pour déterminer si l’événement risque d’être affecté par la pluie. |
SQL Query |
Code pour vos requêtes SQL d’exemple. Les requêtes doivent répondre directement au titre et à la description. Snowflake valide automatiquement vos requêtes d’exemple. Pour être valide, une requête d’exemple doit renvoyer au moins une ligne. Si une requête ne parvient pas à être validée, vous pouvez sauvegarder l’annonce, mais celle-ci ne pourra être publiée que lorsque toutes les requêtes de l’échantillon auront été validées avec succès. Vous devez sélectionner un entrepôt à utiliser pour valider la requête SQL. |
Disponibilité de la région (annonces Marketplace uniquement)¶
Le tableau suivant décrit les champs disponibles dans la section Region Availability.
Nom du champ |
Description |
---|---|
Region Availability |
Par défaut, votre annonce est disponible dans All regions. Choisir toutes les régions garantit la disponibilité de votre annonce dans toutes les régions ajoutées à l’avenir par Snowflake. Pour les annonces payantes, la sélection de cette option rend l’annonce disponible dans les régions prises en charge et dans toutes les régions prises en charge ajoutées par Snowflake. Si votre annonce comporte des limitations régionales spécifiques, sélectionnez All regions pour modifier la disponibilité régionale au profit de Custom regions et sélectionnez les régions dans lesquelles vous souhaitez proposer votre produit de données. Lorsque vous choisissez des régions personnalisées, votre annonce est toujours visible dans toutes les régions Snowflake Marketplace, mais les consommateurs ne peuvent obtenir votre produit de données que dans les régions que vous avez spécifiées. |
Fulfillment method |
L’exécution Automatic est sélectionnée par défaut. Grâce à l’exécution automatique inter-Cloud, votre produit de données est automatiquement exécuté dans une région et vous n’engagez des frais que lorsqu’il y a une demande de la part des consommateurs dans cette région. Lorsque vous utilisez l’exécution automatique, vous devez également sélectionner une fréquence d’actualisation pour mettre à jour le produit de données partagé avec les consommateurs. Vous devez sélectionner une fréquence d’actualisation de 8 jours maximum. Si votre produit de données est une Snowflake Native App, vous ne pouvez définir une fréquence d’actualisation qu’au niveau du compte. Pour plus de détails sur l’exécution automatique, consultez Configurer l’exécution automatique inter-Cloud. Si vous ne pouvez pas utiliser l’exécution automatique, sélectionnez Manual pour répliquer manuellement votre produit de données. Pour répondre aux demandes, vous devez configurer des comptes dans les régions demandées par les consommateurs, répliquer manuellement le produit sur chaque compte, créer des partages sécurisés dans chaque compte et joindre ces partages à cette annonce. Voir Répliquer manuellement les données avant d’exécuter une demande d’annonce |
Comptes de consommateurs (annonces privées uniquement)¶
Pour publier une annonce auprès de consommateurs spécifiques, vous devez spécifier les identifiants des comptes avec lesquels vous souhaitez effectuer le partage :
Nom du champ |
Description |
Exemple |
---|---|---|
Consumer Accounts |
Spécifie les comptes Snowflake avec lesquels vous souhaitez partager votre annonce privée. Vous pouvez utiliser des identificateurs de compte Snowflake ou URLs. Consultez Recherche de l’organisation et du nom de compte pour un compte pour plus de détails. |
|
Si vous partagez avec un compte consommateur qui se trouve dans une région différente de celle de votre compte, vous devez aussi configurer l’exécution automatique :
Nom du champ |
Description |
---|---|
Auto-fulfillment |
Sélectionnez l’intervalle et la fréquence de réplication pour votre produit de données. Par exemple, vous pouvez configurer la réplication pour qu’elle ait lieu toutes les deux heures. Si votre produit de données est un paquet d’application, vous ne pouvez définir la fréquence et l’intervalle d’actualisation qu’au niveau du compte. |
Voir Configurer l’exécution automatique inter-Cloud pour plus d’informations.