Uso do banco de dados de amostra¶

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

Neste tópico:

Visualização do banco de dados de amostra¶

Você pode visualizar o banco de dados de amostra e seu conteúdo na interface da Web ou usando SQL:

Snowsight:

Selecione Data » Databases » SNOWFLAKE_SAMPLE_DATA.

Classic Console:

Clique em Databases » SNOWFLAKE_SAMPLE_DATA:

Clique em uma guia de objetos para ver informações resumidas sobre os objetos no banco de dados.

Clique no nome de um objeto para ver detalhes sobre o objeto.

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).

Consulta de tabelas e exibições no banco de dados de amostra¶

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).

Usando scripts SQL de tutorial¶

O Snowflake fornece um conjunto de tutoriais, que são instruções SQL anotadas que consultam os conjuntos de dados de amostra para responder a várias perguntas de negócios práticas.

Para acessar os tutoriais do Classic Console:

Na página Worksheets , clique na seta para baixo ao lado das guias da planilha e selecione Open Tutorials:
O diálogo Open Worksheet exibe a lista de tutoriais disponíveis. No diálogo, selecione um tutorial e clique no botão Open:
Uma nova planilha é criada contendo o conteúdo do tutorial:

Você pode então executar as consultas no tutorial como faria em qualquer planilha. Você também pode alterar o tutorial na planilha e salvá-lo como uma planilha personalizada.