Gestion des annonces 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 annonce de données¶
Considérations pour créer une annonce¶
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 gratuit 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, 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 annonce 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 gratuits, 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 plateformes 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 éléments de liste gratuits, vous avez la possibilité de pré-associer un partage à l’élément de 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 annonce de données¶
Pour créer un élément de liste de données gratuit ou personnalisé :
Dans Snowsight, accédez à Data Products » Private Sharing.
Sélectionnez la liste déroulante Share Data et choisissez un échange de données.
Dans la boîte de dialogue New Listing , entrez le titre de l’annonce tel qu’il apparaît aux consommateurs et sélectionnez le type d’annonce. Pour plus d’informations sur le type d’annonce, voir Types d’annonces.
Remplissez chacune des sections de la nouvelle annonce. Vous pouvez sauvegarder le projet à tout moment pour le terminer plus tard. Pour une description de chaque section et des domaines connexes, voir Référence des propriétés des annonces.
Pour un élément de liste gratuit, 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.
Sélectionnez Select Data.
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.
Sélectionnez Done.
(Facultatif) Vous pouvez modifier le nom par défaut du partage sécurisé.
Sélectionnez Save.
Une fois que vous avez terminé de remplir toutes les sections, sélectionnez Publish pour publier l’annonce dans les régions sélectionnées.
Le bouton Publish n’est pas activé si :
L’une des requêtes SQL d’exemple fournies n’a pas été validée. Pour plus d’informations, voir Champs d’annonce de données.
Vous n’êtes pas le propriétaire du partage.
Champs d’annonce 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 d’annonces |
Valeurs disponibles : Gratuit, 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 gratuit et facultatives pour les éléments de liste personnalisés. |
|
|
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. |
|
|
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 gratuits. |
|
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’annonces personnalisées¶
Note
Des notifications par e-mail sont envoyées aux fournisseurs pour les informer des demandes de données. Vous pouvez modifier l’e-mail de notification de la demande pour une annonce spécifique dans l’onglet Settings.
Pour voir les demandes d’éléments de listes personnalisés :
Accédez à Data Products » Private Sharing.
Sélectionnez l’onglet Requests. Utilisez la liste déroulante de filtrage pour afficher les demandes par statut.
Approbation des demandes de consommateurs d’annonces 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 éléments de liste gratuits, 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 à 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 plateformes Cloud.
Accédez à Data Products » Private Sharing.
Sélectionnez l’onglet Requests.
Cliquez sur Review à côté du nom de l’annonce.
Dans la section Associate Secure Share , sélectionnez un compte où vous souhaitez créer le partage.
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).
Sélectionnez Select Data.
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.
Sélectionnez Done.
(Facultatif) Vous pouvez modifier le nom par défaut du partage sécurisé.
Sélectionnez 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’annonces traitées¶
Les fournisseurs qui traitent des demandes d’annonces gratuites ou personnalisées à l’aide de Snowsight peuvent voir les enregistrements des consommateurs ajoutés au partage en naviguant dans l’onglet Data Products » Private Sharing et en sélectionnant l’onglet Shared by My Account.
Ces enregistrements sont également disponibles dans Vue QUERY_HISTORY.
Gestion des annonces de données existantes¶
Modification d’une annonce 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 :
Connectez-vous à Snowsight en tant que ACCOUNTADMIN.
Dans le menu de navigation , cliquez sur Data Products » Private Sharing » Shared by My Account.
Cliquez sur le nom de l’élément de liste que vous souhaitez mettre à jour.
À côté du titre de l’élément de liste, cliquez sur New Draft.
Cliquez sur Edit pour la section que vous souhaitez mettre à jour.
Cliquez sur Publish.
Annulation de la publication d’une annonce 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 :
Connectez-vous à Data Exchange à l’aide de Snowsight en tant qu’administrateur de compte.
Dans le menu de navigation, sélectionnez Data Products » Private Sharing » Shared by My Account.
Cliquez sur le nom de l’annonce pour laquelle vous souhaitez annuler la publication.
Dans le coin supérieur droit, dans la liste déroulante Live , sélectionnez Unpublish.
Republication d’une annonce de données¶
Pour republier un élément de liste de données :
Connectez-vous à Data Exchange à l’aide de Snowsight en tant qu’administrateur de compte.
Dans le menu de navigation, sélectionnez Data Products » Private Sharing » Shared by My Account.
Sélectionnez le nom de l’annonce que vous souhaitez republier.
Dans le coin supérieur droit, dans la liste déroulante, sélectionnez Re-publish.
Sélectionnez Re-publish pour republier l’annonce.