Use the sample database¶

O banco de dados de amostra, SNOWFLAKE_SAMPLE_DATA, é idêntico aos bancos de dados que você cria em sua conta, exceto que ele é somente leitura. Como tal, as seguintes operações não são permitidas:

Nenhum DDL pode ser realizado nos esquemas do conjunto de dados (ou seja, tabelas e outros objetos do banco de dados não podem ser adicionados, descartados ou alterados).
Nenhum DML pode ser realizado sobre as tabelas nos esquemas.
Nenhuma clonagem ou Time Travel pode ser realizada no banco de dados ou quaisquer esquemas/tabelas no banco de dados.

Entretanto, você pode usar todos os mesmos comandos e sintaxe para visualizar o banco de dados de amostras, esquemas e tabelas, assim como executar consultas nas tabelas.

Importante

O banco de dados de amostra é criado por padrão para contas mais recentes. Se o banco de dados não foi criado para sua conta e você quer ter acesso a ele, execute as seguintes instruções SQL com a função ACCOUNTADMIN ativa:

-- Create a database from the share.
CREATE DATABASE SNOWFLAKE_SAMPLE_DATA FROM SHARE SFC_SAMPLES.SAMPLE_DATA;

-- Grant the PUBLIC role access to the database.
-- Optionally change the role name to restrict access to a subset of users.
GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE_SAMPLE_DATA TO ROLE PUBLIC;

Copy

View the sample database¶

You can view the sample database and its contents either in Snowsight or using SQL:

Snowsight:

No menu de navegação, selecione Catalog » Database Explorer » SNOWFLAKE_SAMPLE_DATA.

SQL:

Execute um comando SHOW DATABASES.

Você também pode usar os comandos SHOW <objetos> relevantes para visualizar os objetos no banco de dados de amostra.

Por exemplo, em SQL:

show databases like '%sample%';

+-------------------------------+-----------------------+------------+------------+-------------------------+--------------+---------+---------+----------------+
| created_on                    | name                  | is_default | is_current | origin                  | owner        | comment | options | retention_time |
|-------------------------------+-----------------------+------------+------------+-------------------------+--------------+---------+---------+----------------|
| 2016-07-14 14:30:21.711 -0700 | SNOWFLAKE_SAMPLE_DATA | N          | N          | SFC_SAMPLES.SAMPLE_DATA | ACCOUNTADMIN |         |         | 1              |
+-------------------------------+-----------------------+------------+------------+-------------------------+--------------+---------+---------+----------------+

Copy

Observe que este exemplo ilustra que o banco de dados de amostra, SNOWFLAKE_SAMPLE_DATA, foi compartilhado com sua conta pelo Snowflake.

A coluna origin na saída SHOW DATABASES (ou a coluna Origin na página Databases na interface) exibe o nome totalmente qualificado do banco de dados compartilhado, SFC_SAMPLES.SAMPLE_DATA, indicando que ele se originou da conta SFC_SAMPLES (usada pelo Snowflake para compartilhar os dados da amostra).

Query tables and views in the sample database¶

Para utilizar uma tabela ou exibição no banco de dados de amostra, você pode optar por uma de duas alternativas:

Fazer referência ao nome totalmente qualificado da tabela em sua consulta (na forma de snowflake_sample_data.schema_name.object_name).

OR
Especificar o banco de dados de amostra (e esquema) para sua sessão usando os comandos USE DATABASE e/ou USE SCHEMA.

Os dois exemplos a seguir ilustram o uso das duas abordagens para consultar a tabela lineitem no esquema tpch_sf1:

select count(*) from snowflake_sample_data.tpch_sf1.lineitem;

+----------+
| COUNT(*) |
|----------|
|  6001215 |
+----------+

use schema snowflake_sample_data.tpch_sf1;

select count(*) from lineitem;

+----------+
| COUNT(*) |
|----------|
|  6001215 |
+----------+

Copy

Nota

Você deve ter um warehouse em funcionamento e atual em sua sessão para realizar consultas. Você define o warehouse atual em uma sessão usando o comando USE WAREHOUSE (ou dentro da planilha na interface da Web).