Consommer des données partagées¶

Limites générales des bases de données partagées¶

Les bases de données partagées ont les limites suivantes pour les consommateurs :

• Les bases de données partagées sont en lecture seule. Les utilisateurs d’un compte consommateur peuvent consulter/interroger des données, mais ne peuvent pas insérer ou mettre à jour des données, ni créer d’objets dans la base de données.

• Les actions suivantes ne sont pas prises en charge :

  • Création d’un clone d’une base de données partagée ou d’un schéma/d’une table dans la base de données.

  • « Time Travel » pour une base de données partagée ou d’un schéma/d’une table dans la base de données.

  • Modification des commentaires d’une base de données partagée.

• Les bases de données partagées et tous les objets de la base de données ne peuvent pas être repartagées (c’est-à-dire partagés de nouveau avec d’autres comptes).

• Les bases de données partagées ne peuvent pas être répliquées.

Affichage des partages disponibles¶

Vous pouvez visualiser les partages qui sont disponibles à la consommation dans votre compte en utilisant l’interface Web ou SQL :

Snowsight:

Sélectionnez Data Products » Private Sharing, puis sélectionnez Shared With You. Vous pouvez voir les éléments suivants :

• Les annonces partagées en privé qui ont été partagées avec vous. Vous pouvez également voir des annonces Data Exchange auxquelles vous avez accès.

• Partages directs qui ont été partagés avec vous. Selon le statut du partage, les partages sont regroupés en deux sections :

  • Les partages directs qui sont prêts à recevoir (c’est-à-dire qu’une base de données n’a pas été créée à partir du partage).

  • Les partages directs qui ont été importés dans une base de données et qui sont prêts à être interrogés.

Pour voir les annonces Snowflake Marketplace qui ont été importées dans une base de données et qui sont prêtes à faire l’objet d’une requête, dans le menu de navigation, sélectionnez Data Products » Marketplace. Pour plus d’informations, voir Découverte des annonces.

Classic Console:

Sélectionnez Shares , puis sélectionnez la bascule Inbound.

La page affiche tous les partages disponibles sur votre compte. La colonne Database affiche le nom de la base de données créée à partir du partage. Si la colonne est vide, une base de données n’a pas encore été créée (dans votre compte) à partir du partage.

SQL:

Exécutez une instruction SHOW SHARES ou DESCRIBE SHARE.

Par exemple, en utilisant SQL :

SHOW SHARES;

Copy

La sortie s’affiche :

• Deux partages, sales_s et sales_s2 sont disponibles. INBOUND dans la colonne kind indique qu’un fournisseur de données a mis le partage à la disposition de votre compte en vue d’une consommation.

• La colonne name affiche le nom de chaque partage, sous la forme share_name (par exemple, SALE_S).

• La colonne owner_account affiche le nom du compte qui a fourni chaque partage, sous la forme orgname.account_name.

• Si la colonne database_name est vide, une base de données n’a pas encore été créée depuis le partage dans votre compte.

+-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------+---------------------+
| created_on                    | kind     | owner_account        | name          | database_name         | to               | owner        | comment                                | listing_global_name |                  |
|-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------|---------------------|
| 2017-07-09 19:18:09.821 -0700 | INBOUND  | SNOW.XY12345         | SALES_S2      | UPDATED_SALES_DB      |                  |              | Transformed and updated sales data     |                     |
| 2017-06-15 17:02:29.625 -0700 | OUTBOUND | SNOW.MY_TEST_ACCOUNT | SALES_S       | SALES_DB              | XY12345, YZ23456 | ACCOUNTADMIN |                                        |                     |
+-------------------------------+----------+----------------------+---------------+-----------------------+------------------+--------------+----------------------------------------+---------------------+

L’exemple suivant utilise la commande DESCRIBE SHARE pour afficher les objets (base de données, schémas et tables) qui sont dans le partage sales_s :

DESC SHARE xy12345.sales_s;

+----------+------------------------------------+---------------------------------+
| kind     | name                               | shared_on                       |
|----------+------------------------------------+---------------------------------|
| DATABASE | <DB>                               | Thu, 15 Jun 2017 17:03:16 -0700 |
| SCHEMA   | <DB>.AGGREGATES_EULA               | Thu, 15 Jun 2017 17:03:16 -0700 |
| TABLE    | <DB>.AGGREGATES_EULA.AGGREGATE_1   | Thu, 15 Jun 2017 17:03:16 -0700 |
| VIEW     | <DB>.AGGREGATES_EULA.AGGREGATE_1_v | Thu, 15 Jun 2017 17:03:16 -0700 |
+----------+------------------------------------+---------------------------------+

Copy

Le partage est constitué d’un schéma, aggregates_eula, avec une table, aggregate_1. Chaque nom d’objet, y compris la base de données elle-même, est doté du préfixe <DB>. Ceci indique qu’une base de données n’a pas encore été créée (dans votre compte) à partir du partage.

Création d’une base de données à partir d’un partage¶

Vous pouvez créer une base de données à partir d’un partage en utilisant l’interface Web ou SQL :

Snowsight:

1. Connectez-vous à Snowsight.

2. Sélectionnez Data Products » Private Sharing.

3. Sélectionnez l’onglet Shared with You.

4. Dans la section Ready to Get, sélectionnez le partage pour lequel vous souhaitez créer une base de données.

5. Définissez un nom de base de données et les rôles qui sont autorisés à accéder à la base de données.

6. Sélectionnez Get Data.

Classic Console:

1. Sélectionnez Shares , puis sélectionnez la bascule Inbound.

2. Sélectionnez un partage à partir duquel une base de données n’a pas encore été créée (c’est-à-dire que la colonne Database est vide).

3. Sélectionnez Create Database from Share.

4. Suivez les invites fournies dans la boîte de dialogue.

SQL:

Exécutez une instruction CREATE DATABASE avec la syntaxe spécifique au partage de données suivante :

CREATE DATABASE <name> FROM SHARE <provider_account>.<share_name>

Copy

Où provider_account est le nom du compte qui a fourni le partage et share_name est le nom du partage à partir duquel créer la base de données.

Attribution de privilèges sur une base de données partagée¶

Les instructions pour accorder l’accès aux objets d’un partage diffèrent selon que le fournisseur a segmenté les objets d’un partage en utilisant des rôles de base de données. Cette option associe différents objets du partage à différents rôles de base de données.

Notez qu’un seul partage peut inclure à la fois des objets accessibles via des rôles de base de données et des objets qui ne sont pas associés à un rôle de base de données.

CREATE DATABASE c1 FROM SHARE provider1.share1;

SHOW DATABASE ROLES in DATABASE c1;
GRANT DATABASE ROLE c1.r1 TO ROLE analyst;

Création de flux sur des vues ou des tables partagées¶

La création de flux sur des objets partagés (vues et tables sécurisées) vous permet de suivre les modifications du langage de manipulation de données (DML) apportées dans ces objets. Cette fonctionnalité est similaire à la création et à l’utilisation de flux sur des objets « locaux » (c’est-à-dire dans le même compte que le flux).

Le rôle utilisé pour exécuter les instructions SQL dans cette section doit avoir les autorisations requises sur la table partagée ou la vue sécurisée. Pour plus d’informations, voir Attribution de privilèges sur une base de données partagée (dans cette rubrique).

• Pour créer des flux sur des vues partagées :

  CREATE STREAM <name> ON VIEW <shared_db>.<schema>.<view>;
  

  Copy

  Par exemple, créez un flux sur la vue aggregate_1_v partagée dans la base de données snow_sales.aggregates_eula et le schéma :

  CREATE STREAM aggregate_1_v_stream ON VIEW snow_sales.aggregates_eula.aggregate_1_v;
  

  Copy

• Pour créer des flux sur des tables partagées :

  CREATE STREAM <name> ON TABLE <shared_db>.<schema>.<table>;
  

  Copy

  Par exemple, créez un flux de table sur la table aggregate_1 partagée dans la base de données et le schéma snow_sales.aggregates_eula :

  CREATE STREAM aggregate_1_stream ON TABLE snow_sales.aggregates_eula.aggregate_1;
  

  Copy

Pour plus d’informations sur la création de flux, consultez CREATE STREAM.

Interrogation d’une base de données partagée¶

L’interrogation d’une base de données partagée est la même que celle de toute autre base de données de votre compte.

Par exemple :

USE ROLE r1;

USE DATABASE snow_sales;

SELECT * FROM aggregates_1;

Copy