Tabelas interativas e warehouses interativos do Snowflake¶

Criação de uma tabela interativa¶

A criação de tabelas segue a sintaxe padrão CTAS (CREATE TABLE AS SELECT), com a palavra-chave adicional INTERACTIVE que define o tipo da tabela.

O comando CREATE INTERACTIVE TABLE também requer uma cláusula CLUSTER BY. Especifique uma ou mais colunas na cláusula CLUSTER BY para corresponder às cláusulas WHERE em suas consultas mais urgentes. As colunas especificadas na cláusula CLUSTER BY podem afetar significativamente o desempenho das consultas na tabela interativa. Portanto, escolha as colunas de clustering com cuidado. Para obter mais informações sobre como escolher as melhores colunas de clustering, consulte Chaves de clustering e tabelas clusterizadas.

O comando a seguir cria uma tabela interativa contendo as mesmas colunas e dados que uma tabela padrão. A cláusula CLUSTER BY refere-se a uma coluna chamada id da tabela de origem.

CREATE INTERACTIVE TABLE
  IF NOT EXISTS orders
  CLUSTER BY (id)
AS
  SELECT * FROM demoSource;

TARGET_LAG = '<num> { seconds | minutes | hours | days }'

CREATE INTERACTIVE TABLE my_dynamic_interactive_table
  CLUSTER BY (c1, c2)
  TARGET_LAG = '20 minutes'
  WAREHOUSE = s_maintenance_wh
  INITIALIZATION_WAREHOUSE = xl_initial_wh
AS SELECT c1, SUM(c2) FROM my_source_table GROUP BY c1;

ALTER INTERACTIVE TABLE ``my_dynamic_interactive_table`` REFRESH.

Criação de um warehouse interativo¶

Depois de criar uma tabela interativa, consultar essa tabela com desempenho ideal requer um warehouse interativo. Especifique a palavra-chave INTERACTIVE no comando CREATE WAREHOUSE ou CREATE OR REPLACE WAREHOUSE.

Opcionalmente, você pode especificar uma cláusula TABLES com uma lista de nomes de tabelas interativas separados por vírgulas. O uso dessa cláusula associa imediatamente essas tabelas interativas ao warehouse interativo.

O comando a seguir cria um warehouse interativo associado à tabela interativa chamada orders. Neste caso, você pode executar imediatamente um comando USE WAREHOUSE para o warehouse interativo e começar a executar consultas para a tabela interativa:

CREATE OR REPLACE INTERACTIVE WAREHOUSE interactive_demo
  TABLES (orders)
  WAREHOUSE_SIZE = 'XSMALL';

O comando a seguir cria um warehouse interativo sem tabelas interativas associadas. Neste caso, você executa comandos ALTER WAREHOUSE posteriormente para associar tabelas interativas ao warehouse interativo:

CREATE OR REPLACE INTERACTIVE WAREHOUSE interactive_demo
  WAREHOUSE_SIZE = 'XSMALL';

Após criar um warehouse interativo, ele permanece em estado suspenso até que você o retome. Você pode configurar a suspensão e a retomada automáticas para warehouses interativos. O intervalo mínimo de suspensão automática para um warehouse interativo é de 24 horas (86.400 segundos). Para obter mais detalhes, consulte Retomando e suspendendo um warehouse interativo.

Práticas recomendadas de consulta para warehouses interativos¶

Os warehouses interativos são otimizados para consultas com cargas de trabalho seletivas. Isso significa que consultas com boa seletividade apresentam melhorias de desempenho substancialmente maiores do que outros tipos de consulta.

SELECT col1, col4, AVG(col_x)
  FROM my_table
  GROUP BY col1, col4;

SELECT * FROM my_table;

SELECT col1, col2
  FROM my_table
  WHERE
    col_x IN (1,4,7,8)
    AND event_time >=
      DATEADD(hour, -1, CURRENT_TIMESTAMP());

SELECT col1, col2
  FROM my_table
  WHERE
    event_time >=
      DATEADD(day, -365, CURRENT_TIMESTAMP());

Outras complexidades, como junções grandes (por exemplo, a junção de duas tabelas de fatos) ou expressões que exigem alto poder computacional, como expressões regulares, podem resultar em menor simultaneidade devido ao maior uso de recursos computacionais. Consulte Escolha do tamanho para um warehouse interativo para obter informações sobre como otimizar para essas situações.

Práticas recomendadas de layout de dados para tabelas interativas¶

As tabelas interativas seguem as práticas recomendadas padrão do Snowflake para desempenho. Em particular, as tabelas interativas se beneficiam de uma tabela bem agrupada, uma tabela classificada com base nas mesmas colunas que você está filtrando. Por exemplo, se sua consulta costuma filtrar em uma coluna TIMESTAMP como sale_date, faz sentido usar essa coluna como chave de clustering ao criar a tabela interativa. Por exemplo, você pode criar a tabela interativa da seguinte forma:

CREATE INTERACTIVE TABLE product_sales (<column definitions>) CLUSTER BY (sale_date);

Dessa forma, as consultas SELECT que filtram em sale_date podem ignorar rapidamente todos os dados irrelevantes e retornar resultados. Por exemplo, a consulta a seguir filtra um intervalo de datas testando a coluna sale_date:

SELECT ... WHERE sale_date > '2025-10-24' AND ...

Para obter mais detalhes sobre como escolher as melhores chaves de clustering, consulte Chaves de clustering e tabelas clusterizadas.

Escolha do tamanho para um warehouse interativo¶

Depois de concluir todas as suas consultas e otimizações de layout, considere dimensionar seu warehouse para atender à demanda. Os warehouses interativos têm tamanhos que variam de XSMALL a 3XLARGE, bem como Warehouses multicluster.

Recomendamos que você comece dimensionando seu warehouse com base no tamanho aproximado do conjunto de dados de trabalho na tabela interativa. O conjunto de dados de trabalho se refere à parte dos dados que é consultada com frequência. Por exemplo, se suas consultas normalmente consultam apenas os dados de vendas dos últimos sete dias, o conjunto de trabalho é a fração da tabela interativa correspondente a esses sete dias.

Isso ocorre porque o warehouse interativo utiliza cache de armazenamento local. Embora os dados de todo o seu conjunto de dados (tabela) estejam sempre acessíveis, o acesso a dados não armazenados em cache acarreta maior latência na primeira leitura.

Escolha um tamanho de warehouse que atenda às necessidades de suas cargas de trabalho. Faça testes com seus dados e carga de trabalho específicos para determinar o tamanho ideal do seu warehouse interativo.

Recomendamos começar com os seguintes tamanhos de warehouse de acordo com o tamanho do conjunto de dados de trabalho. (Sujeito a alterações e diferenças de hardware dependendo do provedor de nuvem e da região.)

Adição de uma tabela interativa a um warehouse interativo¶

Para obter o desempenho ideal de consulta para uma tabela interativa, você deve usar um warehouse interativo.

Antes de consultar a tabela interativa a partir de um warehouse interativo, você deve realizar uma operação única para adicionar a tabela ao warehouse. Caso contrário, você verá um erro object not found ao executar uma consulta em tal tabela a partir do warehouse interativo. Se você não especificou as tabelas interativas a serem associadas aos warehouses interativos usando a cláusula TABLES em seu comando CREATE INTERACTIVE WAREHOUSE, pode fazer isso posteriormente usando um comando ALTER WAREHOUSE.

O comando a seguir associa a tabela orders ao warehouse interactive_demo. Você pode especificar vários nomes de tabela, separados por vírgulas, com a cláusula ADD TABLES.

ALTER WAREHOUSE interactive_demo ADD TABLES (orders);

Se a tabela interativa já estiver associada ao warehouse interativo, o comando será bem-sucedido, mas não terá efeito. Você pode associar uma tabela interativa a vários warehouses interativos.

Essa ação inicia o processo de aquecimento do cache. O tempo de aquecimento do cache é baseado no tamanho dos dados e do warehouse. Um warehouse XS é aquecido em aproximadamente 300 a 350MB por segundo. Quanto maior a tabela, maior será o tempo de aquecimento do cache. Warehouses maiores são aquecidos mais rapidamente.

O processo de aquecimento não impede que o warehouse aceite novas consultas. A prioridade de aquecimento é: 1. Consultas emitidas pelo usuário 2. Micropartições recém-adicionadas por meio da atualização automática ou por outros meios de ingestão de dados 3. Todos os dados existentes

Como o aquecimento do cache depende das suas consultas, a melhor maneira de monitorar se o cache está aquecido é revisar a porcentagem de leitura remota em Perfil de consulta do Snowsight. Para acesso programático às estatísticas do operador de consulta, confira GET_QUERY_OPERATOR_STATS. Em cenários de execução ideais, as consultas de baixa latência devem ter uma porcentagem de leitura remota de 0%.

Remoção de uma tabela interativa de um warehouse interativo¶

Você pode desanexar uma ou mais tabelas interativas de um warehouse interativo executando um comando ALTER WAREHOUSE com a cláusula DROP TABLES.

ALTER WAREHOUSE interactive_demo DROP TABLES (orders, customers);

Usando otimização de pesquisa para pesquisas pontuais¶

Recomendamos adicionar a otimização de pesquisa quando você realizar consultas de pesquisa pontual em sua tabela interativa. Pesquisas pontuais são consultas que filtram por uma única coluna para recuperar uma ou algumas linhas de dados. Um bom exemplo é WHERE some_id = some_UUID.

Práticas recomendadas para exibições materializadas interativas¶

Siga estas diretrizes ao criar exibições materializadas usando tabelas interativas:

• A exibição materializada interativa funciona apenas como exibições materializadas comuns. Ela deve ser baseada em uma tabela interativa.

• A exibição materializada interativa e a tabela interativa de origem na qual ela se baseia devem ser adicionadas ao mesmo warehouse interativo. Caso contrário, você verá o erro object not found ao executar uma consulta nessa exibição materializada usando o warehouse interativo.

• Junções não são compatíveis em exibições materializadas, sejam elas interativas ou padrão. Estruture suas consultas para agregar ou filtrar a partir de uma única tabela base.

• Você não pode usar uma tabela interativa ou uma exibição materializada interativa como fonte para uma tabela dinâmica.

• Ao considerar candidatos para exibições materializadas interativas, escolha consultas de agregação que sejam executadas com frequência e que tenham alto custo computacional

Retomando e suspendendo um warehouse interativo¶

O comando a seguir retoma um warehouse interativo. Você deve fazer isso após criar o warehouse, pois ele é criado em um estado suspenso:

ALTER WAREHOUSE interactive_demo RESUME;

Você também faz isso para iniciar a execução de consultas por meio do warehouse, caso o tenha suspendido manualmente.

As consultas serão lentas enquanto o cache estiver sendo aquecido após a retomada. Isso pode levar de alguns minutos a uma hora, dependendo da quantidade de dados na tabela.

O comando a seguir suspende um warehouse interativo:

ALTER WAREHOUSE interactive_demo SUSPEND;

CREATE INTERACTIVE WAREHOUSE interactive_demo
  WAREHOUSE_SIZE = 'XSMALL'
  AUTO_SUSPEND = 86400
  AUTO_RESUME = TRUE;

ALTER WAREHOUSE interactive_demo SET
  AUTO_SUSPEND = 86400
  AUTO_RESUME = TRUE;

Dimensionamento multicluster baseado em tarefas¶

Você pode ajustar os parâmetros MIN_CLUSTER_COUNT por meio de tarefas agendadas.

-- 1) Task to scale OUT during business hours
CREATE OR REPLACE TASK mcw_scale_out_morning
  WAREHOUSE = my_wh          -- the warehouse that *executes the task*
  SCHEDULE = 'USING CRON 0 8 * * * UTC'   -- 08:00 UTC daily
AS
  ALTER WAREHOUSE my_wh      -- the warehouse you want to change (can be same or different)
    SET
      MIN_CLUSTER_COUNT = 10;  -- optional: ECONOMY or STANDARD

-- 2) Task to scale IN after hours
CREATE OR REPLACE TASK mcw_scale_in_evening
  WAREHOUSE = my_wh
  SCHEDULE = 'USING CRON 0 20 * * * UTC'  -- 20:00 UTC daily
AS
  ALTER WAREHOUSE my_wh
    SET
      MIN_CLUSTER_COUNT = 2;

É recomendável definir MAX_CLUSTER_COUNT usando uma política de dimensionamento automático para acomodar o pico de simultaneidade de sua carga de trabalho.

Descarte de um warehouse interativo¶

Você pode executar o comando DROP WAREHOUSE para remover completamente um warehouse interativo. Descartar um warehouse interativo remove as associações entre esse warehouse e quaisquer tabelas interativas. No entanto, você ainda pode usar outros warehouses interativos para consultar essas mesmas tabelas interativas.

Consulta a uma tabela interativa¶

Na sua sessão de consulta, certifique-se de que o warehouse para a sua sessão atual seja um warehouse interativo:

USE WAREHOUSE interactive_demo;

Depois disso, você pode consultar sua tabela interativa normalmente.

Práticas recomendadas para benchmarking¶

Sempre que avaliar o desempenho das tabelas interativas em um ambiente de teste, siga estas práticas recomendadas para evitar resultados inconsistentes ou errôneos:

• Desative o cache de resultados da consulta para tornar os resultados do benchmark consistentes entre várias execuções de benchmark. Você pode desativar o cache de resultados da consulta no nível da conta, do usuário e da sessão definindo o parâmetro de sessão USE_CACHED_RESULT. Dessa forma, as consultas usarão apenas o cache de dados de tabela do warehouse interativo. Ao ativar o cache de resultados em seu ambiente de produção, você pode esperar um desempenho igual ou melhor do que nos testes de benchmark.

• Como o warehouse interativo leva um tempo para preparar o cache de dados de tabela, aguarde um pouco depois de criar ou retomar um warehouse interativo antes de testar o desempenho da consulta. Isso simula a configuração de produção típica, em que o warehouse permanece ativo por longos períodos. O Snowflake aplica otimizações ao processo de preparação do cache. Portanto, é mais eficiente deixar o Snowflake completar esse processo do que você mesmo preparar o cache executando consultas de amostra.

• Ao comparar o desempenho das tabelas interativas com as tabelas padrão do Snowflake, não intercale as consultas entre as tabelas padrão e interativas. Em vez disso, execute o benchmark completo com as tabelas padrão e depois execute os mesmos testes com as tabelas interativas.

• Durante os benchmarks comparativos com outros sistemas de banco de dados, certifique-se de que as colunas de clustering em suas tabelas interativas correspondam aos predicados da cláusula WHERE em suas consultas. Para obter mais informações sobre como escolher as melhores colunas de clustering, consulte Chaves de clustering e tabelas clusterizadas. Em particular, não clusterize usando colunas com alta cardinalidade, como IDs exclusivos ou carimbos de data/hora.

• Se as consultas são curtas e simples, você pode obter maior simultaneidade definindo o parâmetro MAX_CONCURRENCY_LEVEL como um valor mais alto para o warehouse interativo.

Limitações dos warehouses interativos¶

• Os warehouses interativos do Snowflake são otimizados para consultas de curta duração. O tempo limite de consulta para comandos SELECT é definido como cinco segundos por padrão. Após cinco segundos, a consulta é cancelada. Você pode reduzir o valor do tempo limite da consulta, mas não pode aumentá-lo. Isso foi desenvolvido no projeto para impedir que consultas de longa duração esgotem os recursos do warehouse interativo e prejudiquem o desempenho das consultas de baixa latência. Alguns tipos de comandos, como SHOW e INSERT OVERWRITE, não estão sujeitos ao intervalo de tempo limite de cinco segundos.

• Se uma consulta expira de maneira consistente, isso indica que ela pode não ser adequada para uso com warehouses interativos. Geralmente, a aplicação de algumas técnicas de ajuste de desempenho pode ajudar a reduzir a latência da consulta. Consulte Considerações sobre o desempenho das tabelas interativas para obter mais detalhes.

• Os warehouses interativos oferecem suporte à suspensão e retomada automáticas com um intervalo mínimo de suspensão automática de 24 horas (86.400 segundos). Espere uma latência de consulta significativa ao retomar um warehouse interativo, pois o cache de dados precisa ser aquecido novamente. Para obter mais informações, consulte Retomando e suspendendo um warehouse interativo.

• Não é possível consultar tabelas padrão do Snowflake a partir de um warehouse interativo. Para consultar as tabelas padrão e interativas na mesma sessão, execute USE WAREHOUSE para alternar para o tipo de warehouse apropriado.

• Você pode adicionar no máximo 10 tabelas interativas a um warehouse interativo. Esta é uma limitação temporária para impedir a sobrecarga do sistema. Esse limite será aumentado no futuro. Se você precisa adicionar mais de 10 tabelas interativas, entre em contato com o suporte Snowflake.

• Não é possível executar comandos CALL para chamar procedimentos armazenados em um warehouse interativo.

• Não é possível usar o :doc:` operador de canal </sql-reference/operators-flow>` ->>. Internamente, esse operador usa procedimentos armazenados.

Limitações das tabelas interativas¶

• As tabelas interativas não são compatíveis com os seguintes recursos:

  • Comandos de linguagem de manipulação de dados (DML), como UPDATE e DELETE. O fluxo de trabalho recomendado é usar tabelas interativas de atualização automática (ou seja, definindo TARGET_LAG) e aplicar DML à tabela de origem. O mecanismo de atualização automática é mais eficiente e econômico do que o uso de DML na tabela interativa. A única DML que você pode executar é INSERT OVERWRITE.

  • Fail-safe. Esse mecanismo de recuperação de dados não está disponível para tabelas interativas. No entanto, você ainda pode usar o Time Travel com tabelas interativas.

  • Carimbos de data/hora de linha. Não é possível habilitar carimbos de data/hora de linha em uma tabela interativa. Esta é uma limitação temporária.

  • Insights de consulta. Atualmente, eles não são coletados ou estão disponíveis para consultas executadas em tabelas interativas para ajudar a reduzir a latência de execução das consultas.

• Não é possível executar as seguintes operações:

  • Use uma tabela interativa como fonte para uma exibição materializada padrão (não interativa). Para criar uma exibição materializada em uma tabela interativa, use a palavra-chave INTERACTIVE. Consulte Compatibilidade com exibições materializadas para tabelas interativas.

  • Modificar propriedades de uma tabela interativa usando as cláusulas ALTER TABLE, como ADD COLUMN ou REMOVE COLUMN. Veja a seguir algumas das operações ALTER TABLE que você pode executar:

    • Renomear a tabela.

    • Modificar colunas para definir ou remover a definição de comentários.

    • Definir ou remover a definição de políticas de mascaramento em colunas.

    • Adicionar ou remover a definição de uma política de mascaramento, política de junção, política de agregação ou política de acesso a linhas na tabela.

    • Adicionar ou descartar uma política de ciclo de vida de armazenamento da tabela.

  • Usar fluxos com uma tabela interativa.

  • Criar uma tabela dinâmica com uma tabela interativa como tabela base.

  • Usar a cláusula RESAMPLE para consultas em uma tabela interativa.

  • Definir o período de retenção do Time Travel usando CREATE INTERACTIVE TABLE ou ALTER TABLE. As tabelas interativas herdam o valor DATA_RETENTION_TIME_IN_DAYS do respectivo esquema, banco de dados ou conta pai.