Gestion des listes de données

Une fois que vous êtes devenu un fournisseur de données agréé, vous pouvez commencer à ajouter vos listes de données à Snowflake Data Marketplace.

Chaque liste de données soumise à Snowflake Data Marketplace doit passer par le processus d’examen et d’approbation de Snowflake.

Les fournisseurs de données créent une liste de données et la soumettent pour approbation. Si vous avez plusieurs listes dans Snowflake Data Marketplace, chaque liste doit passer par le processus d’approbation séparément.

Une fois qu’un élément de liste est approuvé, vous pouvez le publier dans Snowflake Data Marketplace. Si un élément de liste a été rejeté, vous pouvez consulter les commentaires, mettre à jour l’élément de liste et le soumettre à nouveau pour approbation.

Si vous modifiez un élément de liste approuvé, vous devez le soumettre à nouveau pour approbation. L’exception est la section Visibilité de la région qui peut être modifiée à tout moment sans autorisation supplémentaire.

Pour vous assurer que la soumission de votre élément de liste de données se déroule correctement et ne déclenche pas de rejet, assurez-vous que les métadonnées de l’élément de liste répondent aux exigences.

Dans ce chapitre :

Autorisations requises pour travailler avec des éléments de liste et des partages

Tâche

Autorisations requises

Modification des détails/métadonnées d’un élément de liste

Pour effectuer cette tâche, le rôle doit avoir les privilèges OWNERSHIP ou MODIFY sur l’élément de liste.

Affichage d’un élément de liste

Pour effectuer cette tâche, le rôle doit avoir les privilèges OWNERSHIP, MODIFY ou USAGE sur l’élément de liste.

Association d’un partage à un élément de liste

pour exécuter la tâche, le rôle doit avoir : . - Le privilège OWNERSHIP sur le partage et . - Les privilèges OWNERSHIP ou MODIFY sur l’élément de liste.

Si le rôle n’a pas la combinaison d’autorisations requise, l’exécution de ces tâches sur l’élément de liste échouera.

Pour plus d’informations sur les rôles, voir Accord de privilèges de fournisseur pour d’autres rôles sur Snowflake Marketplace ou un Data Exchange.

Considérations pour la création d’un élément de liste de données

Considérations générales pour la création d’un élément de liste de données

Note

Ces considérations s’appliquent également à la création d’un élément de liste dans une région éloignée.

  • Etant donné que les données sont partagées entre différents comptes, les consommateurs de données devraient pouvoir utiliser des objets de données partagés sans utiliser d’identificateurs entre guillemets doubles (voir Exigences relatives à l’identificateur). Par conséquent, les identificateurs d’objets pour les tables, les colonnes et les noms de partage doivent être en majuscules et utiliser uniquement des caractères alphanumériques.

  • Pour garantir que vos données sensibles dans une base de données partagée ne soient pas exposées aux utilisateurs des comptes de consommateurs, voir Utilisation d’objets sécurisés pour contrôler l’accès aux données.

  • Les partages actuellement partagés avec un compte consommateur (c’est-à-dire via un partage direct) peuvent être ajoutés à un élément de liste. Les consommateurs doivent accepter les conditions des éléments de liste dans une interface Web Snowflake Data Marketplace avant de pouvoir créer une base de données à partir du partage.

  • Seul le rôle à qui appartient le partage peut rattacher un partage à un élément de liste. Pour plus d’informations sur les privilèges du partage de données, voir Attribution de privilèges à d’autres rôles.

  • Un partage ne peut être rattaché qu’à un seul élément de liste. Si un partage a déjà été rattaché à un élément de liste, il ne peut pas être rattaché à un autre élément de liste, même si l’élément de liste a été supprimé.

  • Avant qu’un élément de liste nouveau ou modifié puisse être soumis pour approbation ou publié, tous les exemples de requêtes sont validés automatiquement pour garantir que tous les objets référencés sont ajoutés au partage et que les requêtes peuvent être exécutées avec succès.

  • Les données doivent être légalement partageables (c’est-à-dire que le fournisseur doit être propriétaire des données ou avoir le droit de les partager).

    Note

    Dans la mesure où les données de votre liste ou ensemble de données sont régies par des lois ou des obligations contractuelles, vous devez vous assurer que vous avez les droits légaux et contractuels de partager ces données. Par exemple, vous pouvez uniquement partager des informations médicales protégées (PHI) via un partage de données personnalisé et, pour ce faire, vous devez : (1) avoir signé un accord de partenariat commercial (BAA) avec Snowflake et le consommateur recevoir les PHI, et ; (2) vous assurer que le consommateur a également signé un BAA avec Snowflake. En outre, si vous pouvez partager des données personnelles par le biais d’un partage de données standard ou personnalisé, vous devez pour cela disposer des droits légaux et contractuels applicables si les données ne sont pas accessibles au public.

  • L’élément de liste et le partage de données doivent être conformes aux politiques des fournisseurs de Snowflake.

Considérations relatives à la création d’un élément de liste de données dans une région distante

  • Lorsque vous publiez un élément de liste, les consommateurs verront votre élément de liste dans toutes les régions sélectionnées.

  • Si les éléments de liste sont automatiquement reproduits, les données ne le sont pas.

  • Pour les éléments de liste standard, vous devez reproduire les données pour chacune des régions sélectionnées avant de publier l’élément de liste.

  • Pour les éléments de liste personnalisés, vous pouvez reproduire les données à la demande du consommateur.

  • Veillez à consacrer du temps à la mise en place de la reproduction et à comprendre les coûts qu’elle implique.

  • Pour partager des données dans une région, vous devez avoir un compte dans cette région afin de répliquer les données. Si vous avez plusieurs comptes, tous les comptes doivent appartenir à la même organisation.

  • Lorsque vous publiez une liste dans une région distante, vous pouvez soit autoriser tous les comptes de votre organisation à répondre aux demandes de listes, soit ajouter explicitement des comptes individuels en tant que fournisseurs. Seul le propriétaire de la liste peut préciser qui peut répondre aux demandes de listes.

  • Le partage de données entre régions utilise la fonctionnalité de réplication de données Snowflake. Pour plus d’informations, voir Partage sécurisé des données entre les régions et les plates-formes Cloud.

  • Vous n’avez pas besoin de répliquer les données dans chaque région jusqu’à ce qu’un consommateur en fasse la demande.

  • Pour les listes standard, vous avez la possibilité de pré-associer un partage à la liste dans une région distante. Cela permettra aux consommateurs d’obtenir le partage instantanément sans soumettre de demande.

  • Pour afficher la liste des partages associés à un élément de liste dans une région distante, vous devez vous connecter au compte distant à partir duquel vous avez joint le partage à l’élément de liste.

Création d’un nouvel élément de liste de données

Création et publication d’un nouvel élément de liste de données

Pour créer un élément de liste de données standard ou personnalisé :

  1. Dans la nouvelle interface Web Snowflake, accédez à Data » Manage » Snowflake Data Marketplace » My Listings.

  2. Cliquez sur le bouton Nouvel élément de liste.

  3. Dans la boîte de dialogue New Listing, entrez le titre de l’élément de liste tel qu’il apparaît aux consommateurs et sélectionnez le type d’éléments de liste. Pour plus d’informations sur le type d’éléments de liste, voir Types de listes de données.

  4. Remplissez chacune des sections pour le nouvel élément de liste. Vous pouvez sauvegarder le projet à tout moment pour le terminer plus tard. Pour une description de chaque section et des domaines connexes, voir Champs d’éléments de liste de données.

    Pour un élément de liste standard, pour associer un partage à l’élément de liste, lors de l’édition de la section Data :

    Note

    Tant qu’un élément de liste n’est pas publié, il ne peut être associé qu’à un partage du compte local/primaire. Une fois l’élément de liste publié, il peut être associé à un partage dans les régions supplémentaires que vous avez sélectionnées.

    1. Cliquez sur Select Data.

    2. S’il existe un partage sécurisé, naviguez jusqu’au partage et sélectionnez-le. Si un partage n’existe pas, naviguez jusqu’à la base de données souhaitée et sélectionnez les objets de la base de données que vous souhaitez ajouter au partage.

      Note

      Si vous ne voyez pas de partage, c’est soit qu’il est déjà rattaché à un autre élément de liste, soit qu’il a déjà été partagé avec des consommateurs.

    3. Cliquez sur Done.

    4. (Facultatif) Vous pouvez modifier le nom par défaut du partage sécurisé.

    5. Cliquez sur Save.

  5. Une fois que vous avez rempli toutes les sections, le bouton Submit for Approval est activé et vous pouvez soumettre l’élément de liste pour approbation.

    Le bouton Submit for Approval n’est pas activé si :

  6. Une fois l’élément de liste examiné par Snowflake, l’état passe à Approved ou Denied. Si l’élément de liste a été refusé, mettez-le à jour en fonction du retour fourni dans les commentaires et soumettez-le de nouveau pour approbation.

    Les fournisseurs Snowflake Data Marketplace sont informés lorsque leur élément de liste est approuvé ou refusé. Une notification par e-mail est envoyée aux adresses e-mail Business Contact et Technical Contact présentes dans le profil du fournisseur associé à l’élément de liste.

    Pour plus d’informations, voir Champs de profil de fournisseur.

  7. Lorsque l’élément de liste est approuvé, accédez à Data » Manage » Snowflake Data Marketplace » My Listings.

  8. Sélectionnez l’élément de liste approuvé.

  9. Cliquez sur Publish Listing pour le publier dans les régions sélectionnées. Un élément de liste approuvé n’est pas publié automatiquement.

Champs d’éléments de liste de données

Le tableau suivant décrit les paramètres requis pour créer et configurer un élément de liste de données dans Snowflake Data Marketplace.

Section

Nom du champ

Description

Exemple

Informations de base

Type d’éléments de liste

Voir Types de listes de données. Une fois que vous avez publié un élément de liste, le type d’élément de liste et le partage sécurisé ne peuvent plus être modifiés.

Valeurs disponibles : Standard / Personnalisée.

Profil

Le nom du profil de fournisseur qui détient le partage. Vous devez créer un profil de fournisseur avant de pouvoir publier des éléments de liste.

Titre

Titre de l’ensemble de données. Le titre de l’élément de liste ne peut pas dépasser 110 caractères, mais il est recommandé qu’il soit compris entre 40 et 60 caractères. Tous les mots importants doivent être mis en majuscules (c’est-à-dire suivre le format de la casse du titre). . Le titre apparaît sous le nom de votre entreprise sur la vignette de l’élément de liste. Il doit être unique (c’est-à-dire différent de tous les autres éléments de liste que vous pouvez avoir). . Si vous décidez d’utiliser une liste Standard pour présenter un sous-ensemble de vos données et un élément de liste Personnalisé pour permettre aux consommateurs de demander l’ensemble de données complet, veillez à distinguer les deux éléments de liste avec des titres différents, mais apparentés. Par exemple, <titre-demo> pour l’élément de liste Standard et <titre> pour l’élément de liste Personnalisé. . Les éléments de liste standard utilisés pour présenter d’autres éléments de liste personnalisés doivent utiliser un suffixe -Demo ou -Sample. . Les éléments de liste standard disponibles pour une durée limitée doivent utiliser un suffixe -Trial.

Météo historique par code postal.

Sous-titre

Sous-titre de l’élément de liste des données. Le sous-titre ne peut pas dépasser 110 caractères et seul le premier mot du sous-titre doit être en majuscule. Le titre et le sous-titre ne doivent pas être répétitifs.

Données météorologiques historiques par emplacement.

Fréquence de mise à jour des données

Fréquence de mise à jour des données. Sélectionnez la fréquence souhaitée dans la liste déroulante des valeurs disponibles.

Catégorie

Les éléments de liste de données sont classés pour une découverte facile. Sélectionnez la catégorie souhaitée dans la liste déroulante des valeurs disponibles.

Conditions de service

Un lien vers les conditions d’utilisation du fournisseur hébergées sur le site Web du fournisseur. Les consommateurs acceptent les conditions avant de pouvoir accéder aux données. Des conditions de service sont obligatoires pour les éléments de liste standard et facultatives pour les éléments de liste personnalisés.

https://www.acme.com/en/legal

Détails

Description

Description de l’ensemble de données partagé. La description doit comporter 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 inclure : . (a) Un paragraphe d’introduction avec l’échelle des données . (b) Une description des tables/vues incluses . (c) Des champs de données clés . Pour les éléments de liste de services et d’enrichissement de données, la description doit inclure le flux de travail prévu pour que les consommateurs accèdent à vos services ou fonctions sécurisées. La description peut éventuellement inclure des sources ou des informations supplémentaires non couvertes par les autres champs de saisie.

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 données sont 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. . Echantillons/tables inclus : . - Données météorologiques historiques quotidiennes de 2016 à aujourd’hui . - Données météorologiques prévisionnelles quotidiennes sur 15 jours . - Données climatologiques quotidiennes sur 15 ans (statistiques météorologiques, c.-à-d. moyenne, std, fréquence, etc.) . Champs inclus : . - Date . - Code postal . - Pays . - Statistiques météorologiques Min, Max, Moy (température, précipitations, vent, humidité, etc.)

Lien vers la documentation

Un lien vers une page du site Web du fournisseur avec une documentation plus détaillée. La documentation doit être claire et faire référence aux bons objets de schéma présents dans le partage. Le lien doit être accessible et non verrouillé derrière un écran de connexion.

https://developer.acme.com

Données

Objets de la base de données ou partage sécurisé

Données que vous souhaitez partager. Cette section n’est disponible que pour les éléments de liste de données standard.

Besoins professionnels

Besoin professionnel

Les éléments de listes de données sont regroupés par besoins professionnels pour faciliter la recherche. . - Vous pouvez sélectionner jusqu’à six besoins professionnels pour votre élément de liste. Si vous ne voyez pas de besoin professionnel pertinent dans la liste déroulante, vous pouvez en créer un personnalisé. . - Les consommateurs peuvent facilement découvrir les éléments de liste en fonction des besoins professionnels disponibles dans la liste déroulante. Toutefois, les besoins professionnels personnalisés que vous ajoutez ne sont pas inclus et ne sont visibles que dans les détails de votre élément de liste. . - Vous pouvez modifier la liste des besoins professionnels à tout moment sans renvoyer l’élément de liste en vue de l’approbation d’un administrateur.

Description

Description de la manière dont vos données ou votre service de données répondent au besoin de l’entreprise.

Exemple de requête SQL

Titre

Titre descriptif de la requête pour aider les consommateurs à comprendre les données. Vous pouvez ajouter plus d’un exemple.

Déterminez si un événement en plein air sera affecté par la pluie.

Description (facultatif)

Description de l’exemple avec des instructions supplémentaires, par exemple nom du schéma, exemples de tables, champs, cas d’utilisation. Utilisez le format <schéma>.<table> pour référencer les tables et les vues dans votre SQL, et n’incluez pas le nom de la base de données dans la requête.

Si vous organisez un événement en plein air dans 7 jours, utilisez nos données de prévision pour déterminer si l’événement peut être affecté par la pluie.

Requête SQL

Testez les exemples de requêtes par rapport à la base de données que vous utilisez pour créer le partage. Snowflake valide automatiquement les requêtes pour s’assurer que tous les objets référencés sont ajoutés au partage et que les requêtes s’exécutent correctement. Si la validation échoue, un message d’erreur avec un motif est affiché. Vous pouvez voir un signe d’exclamation à côté de chaque requête qui a échoué.

Disponibilité de la région

Toutes les régions disponibles ou Régions spécifiques

Régions dans lesquelles votre élément de liste sera visible. Vous devrez répliquer les données dans ces régions. Vous pouvez modifier la liste des régions disponibles à tout moment sans renvoyer l’élément de liste en vue de l’approbation d’un administrateur. Si vous supprimez une région qui était auparavant disponible, les consommateurs de cette région ne pourront plus lire l’élément de liste.

Gestion des éléments de liste de données existants

Affichage des requêtes d’éléments de liste personnalisés

Pour afficher les requêtes d’éléments de liste personnalisés :

  1. Dans la nouvelle interface Web, dans le menu de gauche, accédez à Data » Manage » Snowflake Data Marketplace.

  2. Cliquez sur l’onglet Consumer Requests.

Approbation des demandes de données des consommateurs

Note

Si le consommateur se trouve dans une région différente, avant de joindre un partage, vous devez mettre en place une réplication des données sur le compte de la région distante. Pour plus d’informations, voir Partage sécurisé des données entre les régions et les plates-formes Cloud.

  • Pour les éléments de liste personnalisés, les données ne sont pas automatiquement disponibles dans les régions distantes. Le fournisseur est responsable de la réplication de ses données dans chacune de ces régions.

  • Pour les éléments de liste standard :

    • Vous avez la possibilité de pré-associer un partage à l’élément de liste dans une région distante. Cela permet aux consommateurs d’obtenir le partage instantanément sans soumettre de demande.

    • Vous pouvez également répliquer les données et associer un partage à un élément de liste après avoir reçu une demande du premier consommateur d’une région. Une fois que la liste est associée au partage, tous les consommateurs de cette région peuvent accéder instantanément au partage.

  • Vous pouvez préciser si une liste peut être remplie par un ou plusieurs comptes de fournisseurs sélectionnés ou par n’importe quel compte de l’organisation.

Pour approuver une demande d’éléments de liste de données soumise par un consommateur :

  1. Dans la nouvelle interface Web, dans le menu de gauche, accédez à Data » Manage » Snowflake Data Marketplace.

  2. Cliquez sur l’onglet Consumer Requests.

  3. Cliquez sur le nom de l’élément de liste pour un statut en attente.

  4. Dans la section Associate Secure Share sélectionnez un compte où vous souhaitez créer le partage.

  5. Sélectionnez le rôle qui possède le partage et les objets de base de données partagés, ou qui a les privilèges nécessaires sur les objets de base de données pour pouvoir les ajouter à un partage.

  6. Cliquez sur Select Data.

  7. S’il existe un partage sécurisé, naviguez jusqu’au partage et sélectionnez-le. Si un partage n’existe pas, naviguez jusqu’à la base de données souhaitée et sélectionnez les objets de la base de données que vous souhaitez ajouter au partage.

    Note

    Si vous ne voyez pas de partage, c’est soit qu’il est déjà rattaché à un autre élément de liste, soit qu’il a déjà été partagé avec des consommateurs.

  8. Cliquez sur Done.

  9. (Facultatif) Modifiez le nom par défaut du partage sécurisé.

  10. Cliquez sur Fullfill Request.

    Astuce

    Si vous recevez une erreur lors de l’exécution d’une demande pour une région distante, tenez compte des éléments suivants :

    • Le compte distant a-t-il été ajouté à Marketplace en tant que fournisseur ?

    • Le compte distant fait-il partie de la même organisation que le compte à partir duquel vous avez publié la liste ?

    • Avez-vous créé un nouveau partage à l’aide du rôle ACCOUNTADMIN ?

    • Avez-vous ajouté d’autres consommateurs au partage que vous essayez de rattacher ?

Affichage des demandes d’éléments de liste traitées

Les fournisseurs qui traitent des demandes d’éléments de liste standard ou personnalisées à l’aide de la nouvelle interface utilisateur Snowflake peuvent voir les enregistrements des consommateurs ajoutés au partage (instructions ALTER SHARE) dans l’interface utilisateur classique » l’onglet History . La case à cocher Include client-generated statements doit être cochée. Pour plus d’informations, voir Utilisation de la page Historique pour surveiller les requêtes.

Ces enregistrements sont également disponibles dans Vue QUERY_HISTORY.

Modification d’un élément de liste de données publié

Lorsque vous modifiez un élément de liste de données :

  • Chaque fois que vous modifiez un élément de liste de données, un nouveau brouillon est créé. Vous devez le resoumettre pour approbation et le republier avant que les modifications ne soient disponibles pour les consommateurs.

  • La modification des régions disponibles et des champs de besoins d’entreprise ne nécessite pas d’approbation, vous pouvez effectuer la modification à tout moment.

  • Si vous supprimez une région qui était auparavant disponible, les consommateurs de cette région n’auront plus accès à l’ensemble de données partagé.

  • Une fois qu’un élément de liste est approuvé, vous devez le publier pour le mettre à la disposition des consommateurs.

  • Lorsque vous publiez une nouvelle version de l’élément de liste, elle remplace l’élément de liste publié précédemment.

Pour modifier un élément de liste de données :

  1. Connectez-vous à la nouvelle interface Web de Marketplace en tant que ACCOUNTADMIN.

  2. Dans la barre de navigation de gauche, cliquez sur Data » Manage » Snowflake Data Marketplace.

  3. Cliquez sur l’onglet Listings.

  4. Cliquez sur le nom de l’élément de liste que vous souhaitez mettre à jour.

  • Pour ajouter ou supprimer des régions où l’élément de liste est disponible, cliquez sur Edit dans la section Region Availability. Vous pouvez sauter le reste des étapes, car aucune approbation de l’administrateur n’est requise.

  • Pour modifier d’autres champs, tels que la description de l’élément de liste, cliquez sur Edit dans la section concernée et sélectionnez Continue lorsque vous y êtes invité. Cela génère un nouveau projet qui n’est pas visible pour les consommateurs avant d’être soumis, approuvé et publié.

  • Si vous avez des modifications en cours, sélectionnez le bouton New Draft à côté du titre de l’élément de liste pour continuer à travailler sur un projet existant. Vous pouvez abandonner ce projet en sélectionnant le bouton Delete dans le coin supérieur droit de la page.

  1. Cliquez sur Submit for Approval lorsque vous êtes prêt à soumettre votre nouveau projet pour révision.

Annulation de la publication d’un élément de liste de données

Lorsque vous annulez la publication d’un élément de liste de données, les consommateurs existants peuvent toujours accéder au partage de données, sauf si vous les supprimez du partage. Les nouveaux consommateurs ne peuvent pas voir l’élément de liste supprimé.

Pour annuler la publication d’un élément de liste de données :

  1. Dans la barre de navigation de gauche, cliquez sur Data » Manage » Snowflake Data Marketplace.

  2. Cliquez sur l’onglet Listings.

  3. Cliquez sur le nom de l’élément de liste pour lequel vous souhaitez annuler la publication.

  4. Dans le coin supérieur droit, dans la liste déroulante Live , sélectionnez Unpublish.

Republication d’un élément de liste de données

Lorsqu’une liste de données est republiée, elle ne nécessite pas d’approbation, sauf si des modifications ont été apportées à la liste.

Pour republier un élément de liste de données :

  1. Dans la barre de navigation de gauche, cliquez sur Data » Manage » Snowflake Data Marketplace.

  2. Cliquez sur l’onglet Listings.

  3. Cliquez sur le nom de l’élément de liste que vous souhaitez republier.

  4. Dans le coin supérieur droit, dans la liste déroulante, sélectionnez Publish Listing.

Mise à jour d’un partage de données

Vous pouvez mettre à jour un partage de données à l’aide de l’interface Web classique de Snowflake. Gardez à l’esprit que chaque fois que vous modifiez une liste de données, vous devez en informer les consommateurs pour vous assurer de ne pas interrompre leurs processus.

Voici des exemples de modifications pouvant entraîner des interruptions :

  • Ajout/suppression d’une colonne

  • Modification de noms d’objets

  • Suppression d’objets