Gestion des listes de données

Une fois que vous êtes devenu un fournisseur de données agréé dans un Data Exchange, vous pouvez commencer à ajouter vos éléments de listes de données.

Dans ce chapitre :

Création d’une nouvelle liste de données

Considérations pour créer une liste

Note

Ces considérations s’appliquent également à la création d’une 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 Data Exchange avant de pouvoir créer une base de données à partir du partage.

  • Seul le rôle qui a créé le partage peut rattacher le partage à un élément de liste.

  • Un partage ne peut être rattaché qu’à une seule annonce. 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 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.

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

  • 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 à une liste dans une région distante, vous devez vous connecter au compte distant à partir duquel vous avez joint le partage à la liste.

Création et publication d’une 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 » Shared Data.

  2. Cliquez sur la liste déroulante Partager des données et sélectionnez un échange de données.

  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 terminé de remplir toutes les sections, cliquez sur Publish pour publier l’élément de liste dans les régions sélectionnées.

    Le bouton Publish n’est pas activé si :

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 Data Exchange.

Section

Nom du champ

Description

Exemple

Informations de base

Type d’éléments de liste

Voir Types de listes de données.

Valeurs disponibles : Standard, Personnalisé

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’élément de liste de données. Le titre ne peut pas dépasser 110 caractères.

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. 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

La fréquence de mise à jour des données.

Valeurs disponibles : en quasi-temps réel, quotidien, hebdomadaire, mensuel, trimestriel, annuel, jamais (données statiques).

Catégorie

Les éléments de liste de données sont classés pour une découverte facile.

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 inclure : . (a) L’échelle des données . (b) La description des tables/vues . (c) Si l’ensemble de données est un échantillon . (d) Où trouver les dictionnaires de données.

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.

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 Snowflake. Il ne peut pas s’agir d’une simple documentation standard.

https://developer.acme.com

Données

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

Sélectionnez les 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.

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.

Description (facultatif)

Description de l’exemple avec des instructions supplémentaires, par exemple nom du schéma, exemples de tables, champs, cas d’utilisation.

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 la renvoyer 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.

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

Note

Pour le moment, aucune notification par e-mail n’est envoyée aux fournisseurs pour les informer des demandes de données. Vous devez examiner régulièrement les demandes de données dans l’interface Web.

Pour afficher les demandes d’éléments de liste personnalisées :

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

  2. Cliquez sur l’onglet Requests . Utilisez la liste déroulante de filtrage pour afficher les demandes par statut.

Approbation des demandes de consommateurs d’éléments de liste de données dans une région distante

Note

  • 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 listes standard, vous avez la possibilité de pré-associer un partage à la 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 à une 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 :

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 chaque région distante. Pour plus d’informations, voir Partage sécurisé des données entre les régions et les plates-formes Cloud.

  1. Dans la nouvelle interface Web Snowflake, accédez à Data » Shared Data.

  2. Cliquez sur l’onglet Requests .

  3. Cliquez sur Review à côté du nom de l’élément de liste.

  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) Vous pouvez modifier 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 Web Snowflake peuvent voir les enregistrements des consommateurs ajoutés au partage (instructions ALTER SHARE) dans Data » Shared Data » l’onglet Shared by My Account.

Ces enregistrements sont également disponibles dans Vue QUERY_HISTORY.

Gestion des listes de données existantes

Modification d’une liste de données

Lorsque vous publiez une nouvelle version de la liste, elle remplace la liste publiée précédemment. 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é.

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 » Shared Data » Shared by My Account.

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

  4. À côté du titre de l’élément de liste, cliquez sur New Draft.

  5. Cliquez sur Edit pour la section que vous souhaitez mettre à jour.

  6. Cliquez sur Publish.

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

Lorsque vous annulez la publication d’une 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 le voir.

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

  1. Connectez-vous à Data Marketplace à l’aide de la nouvelle interface Web en tant qu’administrateur de compte.

  2. Dans la barre de navigation de gauche, cliquez sur Data » Shared Data » Shared by My Account.

  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

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

  1. Connectez-vous à Data Exchange à l’aide de la nouvelle interface Web en tant qu’administrateur de compte.

  2. Dans la barre de navigation de gauche, cliquez sur Data » Shared Data » Shared by My Account.

  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 Re-publish.

  5. Cliquez sur Re-publish pour republier la liste.

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.