Tabelas interativas e warehouses interativos do Snowflake¶

Limitações dos warehouses interativos¶

• Os warehouses interativos do Snowflake não são compatíveis com consultas de longa 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. Outros tipos de comandos, como SHOW e INSERT OVERWRITE, não estão sujeitos ao intervalo de tempo limite de cinco segundos.

  Os warehouses interativos não foram projetados para uso com consultas de longa duração. Se uma consulta expira de maneira consistente, isso indica que ela pode não ser adequada para uso com warehouses interativos. Caso contrário, você precisa aplicar algumas técnicas de otimização de desempenho para reduzir o tempo para menos de cinco segundos.

• Um warehouse interativo está sempre ativo e em execução por padrão. Ele não é suspenso automaticamente quando está ocioso. Embora seja possível suspender manualmente um warehouse interativo, espere uma latência significativa nas consultas quando você retomar o warehouse.

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

• Se um warehouse interativo for multicluster, ele não terá escalonamento automático. Em um warehouse interativo multicluster, mantenha sempre MIN_CLUSTER_COUNT e MAX_CLUSTER_COUNT com o mesmo valor.

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

• Não é possível usar o operador de canal ->>. Este operador usa procedimentos armazenados nos bastidores.

• Atualmente, os warehouses interativos não são compatíveis com replicação. Eles não estão incluídos em grupos de failover e de replicação.

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. A única DML que você pode executar é INSERT OVERWRITE.

  • Replicação. Eles não estão incluídos em grupos de failover e de replicação.

• Atualmente, os insights de consulta não são coletados nem estão disponíveis para consultas executadas em tabelas interativas.

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

  • Usar uma tabela interativa como origem para uma exibição materializada.

  • Modificar propriedades de uma tabela interativa usando cláusulas ALTER TABLE como ADD COLUMN ou REMOVE COLUMN. A única alteração ALTER TABLE que você pode fazer é renomear a tabela.

  • Usar políticas de mascaramento de dados com uma tabela interativa.

  • Usar políticas de junção com uma tabela interativa.

  • Usar políticas de agregação com uma tabela interativa.

  • Usar políticas de acesso a linhas com uma tabela interativa.

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

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;

Especificação da atualização automática para uma tabela interativa¶

Para que uma tabela interativa seja atualizada automaticamente usando dados de outra tabela, especifique a cláusula TARGET_LAG com um intervalo. Ao especificar TARGET_LAG, você também deve especificar a cláusula WAREHOUSE e o nome de um warehouse padrão que o Snowflake usará para executar operações de atualização.

O intervalo de tempo para a cláusula TARGET_LAG permite especificar o atraso máximo em termos de segundos, minutos, horas ou dias:

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

Se você não especificar uma unidade, o número representará segundos. O valor mínimo é de 60 segundos (1 minuto).

Por exemplo, a seguinte instrução CREATE INTERACTIVE TABLE define uma tabela interativa dinâmica que não fica defasada em mais de 20 minutos em relação a uma tabela de origem especificada e usa um warehouse padrão chamado my_standard_warehouse para executar operações de atualização:

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

Para obter mais informações sobre como escolher um tempo de atraso apropriado que equilibre custos e atualização dos dados, consulte Determinação da meta de atraso ideal para uma tabela dinâmica. Considerações semelhantes se aplicam às tabelas interativas, assim como às tabelas dinâmicas.

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 ativo indefinidamente por padrão. Ao contrário de um modelo tradicional, um warehouse interativo não inclui a opção de suspensão automática se ele ficar ocioso por algum tempo.

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

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 (como 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.

Uso da 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.

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. Você pode criar um warehouse multicluster interativo. No entanto, atualmente, o número mínimo e máximo de clusters deve ser igual. Ou seja, o warehouse multicluster interativo é dimensionado automaticamente.

Recomendamos começar com os seguintes tamanhos de warehouse com base no tamanho do conjunto de dados de trabalho.

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á o erro «objeto não encontrado» 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);

Essa ação inicia o processo de aquecimento do cache. Esse processo pode levar um tempo considerável.

Se a tabela interativa já estiver associada ao warehouse interativo, o comando será executado com sucesso, mas não terá efeito.

Você pode associar uma tabela interativa a vários warehouses interativos.

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

Retomada ou suspensão de um warehouse¶

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;

Você pode suspender o warehouse em ambientes de desenvolvimento e teste, em que ele não será utilizado por muitas horas. Em um ambiente de produção, você normalmente usa warehouses interativos para cargas de trabalho que executam muitas consultas simultâneas 24 horas por dia ou onde a baixa latência é crucial para as consultas. Assim, você normalmente não suspende os warehouses interativos que usa em produção. O Snowflake não suspende warehouses interativos automaticamente.

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.