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 à l’échange 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 minuscules 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.

  • Shares that are currently shared with a consumer account (i.e. via a direct share) can be added to a listing, as long as the same consumer account is also a consumer in the Data Exchange.

  • Seul le rôle qui a créé le partage peut rattacher le partage à une liste.

  • Un partage ne peut être rattaché qu’à une seule annonce. Si un partage a déjà été rattaché à une liste, il ne peut pas être rattaché à une autre liste, même si la liste a été supprimée.

  • 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’une liste dans une région éloignée et à la réplication de données

  • Lorsque vous publiez une liste, vous spécifiez les régions dans lesquelles vous souhaitez que la liste apparaisse. La liste est automatiquement répliquée dans chaque région que vous avez sélectionnée.

  • Vous n’avez pas besoin d’avoir un compte dans une région pour publier une liste (personnalisée ou standard) dans cette région. Cependant, une fois que vous recevez une demande de données d’un consommateur, 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 créez un compte dans une région éloignée, le compte doit être ajouté en tant que fournisseur dans Data Exchange pour pouvoir partager des données. Contactez votre administrateur Data Exchange avec une liste d” URLs pour tous vos comptes distants afin de les ajouter en tant que fournisseurs.

  • La liste est automatiquement répliquée, mais les données ne le sont pas.

  • 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 une liste de données standard ou personnalisée :

  1. (Ignorez cette étape si vous créez une liste personnalisée) Dans l’interface Web classique, créez un partage et ajoutez un ou plusieurs comptes au partage. Pour obtenir des instructions, voir Premiers pas avec le partage de données sécurisé.

    Astuce

    Pour les listes standard, si un partage a des comptes ajoutés, il ne s’affiche pas dans Add Listing.

  2. Dans la nouvelle interface Web, accédez à l’élément de menu Manage, onglet Listings.

  3. Dans la boîte de dialogue Create Listing, fournissez les détails de la liste.

  4. Cliquez sur Publish pour publier la liste dans les régions sélectionnées. Une liste publiée devient visible sous forme de vignette pour tous les membres de Data Exchange dans les régions spécifiées, même si ces membres se trouvent dans une région différente de celle du fournisseur.

  5. (Facultatif) Pré-associez un partage à une liste standard publiée pour rendre le partage disponible aux consommateurs d’une région distante. Pour pré-associer un partage à une liste :

    Note

    Avant de pouvoir associer un partage à une liste dans un compte distant, vous devez répliquer l’ensemble de données sur ce compte.

    1. Dans la nouvelle interface Web, connectez-vous à un compte distant en tant que ACCOUNTADMIN.

    2. Accédez à l’élément de menu Manage », onglet My Listings » <nom_liste> », section Data.

    3. Cliquez sur l’icône de crayon à côté de la section : UI:Données

    4. Associez le partage à la liste.

Champs de listes de données

Le tableau suivant décrit les paramètres requis pour créer et configurer une liste de données dans l’échange de données.

Nom du champ

Description

Exemple

Profil du fournisseur

Sélectionnez le nom du profil de fournisseur qui fournit le partage. Vous devez créer un profil de fournisseur avant de pouvoir publier une liste.

Titre de la liste

Titre de la liste de données. Le titre ne peut pas dépasser 80 caractères.

Météo historique par code postal

Sous-titre

Sous-titre de la liste des données. Le sous-titre ne peut pas dépasser 80 caractères. Le titre et le sous-titre ne doivent pas être répétitifs.

Données météorologiques historiques par emplacement

Description

Description de l’ensemble de données partagé. La description doit indiquer : (a) les meilleurs cas d’utilisation, (b) l’échelle des données, (c) la description des tables/vues, (d) si l’ensemble de données est un échantillon, (e) 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.

Mises à jour des données

Fréquence de mise à jour des données.

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

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

Type d’annonce

Voir Types de listes de données.

Valeurs disponibles : Standard, Personnalisé

Nom de partage

Nom du partage. Pour une liste standard, il s’agit du nom du partage qui sera publié dans l’échange de données. Le partage de données doit appartenir au même rôle que celui qui crée la liste et rattache le partage.

ACME_BENCHMARKS_SHARE

Exemple de titre

Titre d’un cas d’utilisation pour aider les consommateurs à comprendre les données. Vous pouvez ajouter plusieurs exemples en utilisant la navigation sur la droite.

Description

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

Exemple de requête

Exemples d’URLs de requêtes ou d’images pour aider les consommateurs à comprendre les données. Les exemples de requêtes doivent mettre en évidence des aspects intéressants des données. Principales directives pour les exemples de requêtes : (a) Testez les exemples de requêtes par rapport à la base de données que vous utilisez pour créer le partage. Vous devez tester les requêtes par rapport à votre base de données et ne pas essayer de créer une nouvelle base de données à partir de votre propre partage. La création d’une base de données à partir de votre propre partage entraîne un message d’erreur. (b) Utilisez les commentaires SQL pour fournir des instructions, comme le schéma à utiliser ou s’il existe plusieurs schémas dans le partage.

Disponibilité de la région

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

Valeurs disponibles : partout où Data Exchange est disponible, en fonction des régions Snowflake.

Catégorie

Les listes de données sont classées pour une découverte facile.

Affichage des demandes de listes 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 de listes personnalisées :

  1. Dans la nouvelle interface Web, dans le menu de gauche, cliquez sur le lien Manage.

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

Approbation des demandes de listes personnalisées ou de listes standard dans une région distante

Note

Pour les listes standard, 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.

Pour approuver une demande de liste de données soumise par un consommateur :

  1. Dans la nouvelle interface Web, accédez à Data » Manage » Data Exchange » Inbound Requests.

  2. En regard d’une demande, cliquez sur le bouton Review.

  3. Si le consommateur se trouve dans une région différente, avant de joindre un partage :

    1. Connectez-vous à un compte résidant dans la même région que celle d’un consommateur.

    2. Si vous n’avez pas de compte dans cette région, un utilisateur avec le rôle ORGADMIN peut créer un compte.

    Note

    • Si l’objet organisation n’est pas activé, contactez Snowflake pour créer un nouveau compte ou pour demander à rejoindre l’avant-première privée Organisation qui vous permettra de créer vos propres comptes. Pour plus d’informations, voir /LIMITEDACCESS/organizations.

    • Si l’objet organisation est activé, mais que vous ne pouvez toujours pas créer de compte dans une autre région, contactez votre représentation de compte Snowflake pour demander que vos comptes soient liés pour la réplication.

    1. Lorsque vous créez un compte dans une région éloignée, le compte doit être ajouté en tant que fournisseur dans Data Exchange pour pouvoir partager des données. Pour ajouter votre compte distant en tant que fournisseur dans Data Exchange, contactez votre administrateur Data Exchange avec une liste d’URLs pour tous vos comptes distants.

    2. Configurez la réplication des données vers ce compte à partir de votre compte principal. Pour plus d’informations, voir Partage sécurisé des données entre les régions et les plates-formes Cloud.

    Astuce

    Un utilisateur avec le rôle ORGADMIN doit activer les comptes pour la réplication en exécutant la commande suivante :

    -- Assume the ORGADMIN role
    use role orgadmin;
    
    -- View the list of the accounts
    show organization accounts;
    
    -- Enable replication for an account
    SELECT SYSTEM$GLOBAL_ACCOUNT_SET_PARAMETER('<account1_name>',
    'ENABLE_ACCOUNT_DATABASE_REPLICATION', 'true');
    
  4. Pour créer un partage, cliquez sur Create a share dans le lien Console classique.

  5. Si nécessaire, dans l’interface Web classique, créez un nouveau partage et ajoutez des objets au partage. Pour obtenir des instructions, voir Premiers pas avec le partage de données sécurisé.

  6. Dans la nouvelle interface Web, dans la boîte de dialogue Review Request, dans la liste déroulante Secure Share, sélectionnez un partage existant ou le partage nouvellement créé.

    Note

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

  7. Cliquez sur Save. La partage est désormais associé à la liste et est disponible pour le consommateur.

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 de liste traitées

Les fournisseurs qui traitent des demandes 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 » dans 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.

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 mettre à jour une 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 Manage.

  3. Cliquez sur l’onglet My Listings.

  4. Cliquez sur le nom de la liste que vous souhaitez mettre à jour.

  5. Dans le coin supérieur droit, cliquez sur le bouton Modifier et publier.

Annulation de la publication d’une 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’une liste de données :

  1. Connectez-vous à l’échange de données à l’aide de la nouvelle interface Web en tant qu’administrateur de compte.

  2. Dans le menu de gauche, cliquez sur Manage,

  3. Cliquez sur le nom de la liste pour laquelle vous souhaitez annuler la publication.

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

  5. Cliquez sur Unpublish pour annuler la publication de la liste.

Republication d’une liste de données

Pour republier une liste de données :

  1. Connectez-vous à l’échange de données à l’aide de la nouvelle interface Web en tant qu’administrateur de compte.

  2. Dans le menu de gauche, cliquez sur Manage.

  3. Cliquez sur le nom de la 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.