Consommateurs de donné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 transférés (c’est-à-dire partagés de nouveau avec d’autres comptes).

Affichage des partages disponibles¶

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

Classic Web Interface

Cliquez sur Shares , et ensuite sur le bouton 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;

+---------------------------------+---------+-------------------------+-----------------------+----+-------+---------------------------------------------+
| created_on                      | kind    | name                    | database_name         | to | owner | comment                                     |
|---------------------------------+---------+-------------------------+-----------------------+----+-------+---------------------------------------------|
| Thu, 15 Jun 2017 17:02:29 -0700 | INBOUND | XY12345.SALES_S         |                       |    |       |                                             |
| Thu, 15 Jun 2017 17:32:44 -0700 | INBOUND | XY12345.SALES_S2        |                       |    |       |                                             |
| Sat, 09 Jul 2016 19:18:09 -0700 | INBOUND | SFC_SAMPLES.SAMPLE_DATA | SNOWFLAKE_SAMPLE_DATA |    |       | Sample data sets provided by Snowflake      |
+---------------------------------+---------+-------------------------+-----------------------+----+-------+---------------------------------------------+

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 complet de chaque partage, sous la forme provider_account.share_name (par exemple xy12345.sales_s).

• Si la colonne database_name est vide, une base de données n’a pas encore été créée (dans votre compte) à partir du partage.

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

Le partage est constitué d’un schéma, aggregates_eula, avec une table, aggregate_1. Notez que 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 :

Classic Web Interface

1. Cliquez sur Shares , et ensuite sur le bouton 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. Cliquez sur 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>

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;

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

  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;
  

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

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

  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;
  

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;