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 Guia Bancos de dados » 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 Guia Bancos de dados 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:

  1. Na página Worksheets Guia Planilha, clique na seta para baixo ao lado das guias da planilha e selecione Open Tutorials:

    ../_images/ui-sql-worksheet-ws-menu.png
  2. O diálogo Open Worksheet exibe a lista de tutoriais disponíveis. No diálogo, selecione um tutorial e clique no botão Open:

    ../_images/ui-sql-worksheet-ws-dialog.png
  3. Uma nova planilha é criada contendo o conteúdo do tutorial:

    ../_images/ui-sql-worksheet-ws-tutorial.png

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.