Set dynamic table refresh resources - Hologres: Central de Documentação do Alibaba Cloud

Escolha um tipo de recurso

Tipo de recurso	Funcionamento	Mais indicado para
`serverless` (padrão na V4.0.1+)	Utiliza um pool de recursos de Serverless Computing remoto e totalmente gerenciado. O mecanismo determina os recursos necessários por consulta, oferecendo isolamento no nível da consulta e dimensionamento elástico. Não requer capacidade reservada.	A maioria das cargas de trabalho. Padrão na V4.0.1 e posteriores.
`local`	Usa os recursos da instância atual (instância de uso geral) ou o warehouse associado à conexão atual (instância de virtual warehouse na V4.0.7+). Os recursos são compartilhados com outras consultas; pode haver contenção em horários de pico.	Cargas de trabalho que precisam permanecer nos recursos reservados da instância.
`<warehouse_name>`	Executa a atualização em um virtual warehouse específico, proporcionando isolamento de recursos no nível do warehouse. Suportado apenas em instâncias de virtual warehouse (V4.0.7+).	Cargas de trabalho que exigem computação dedicada e isolada em um warehouse específico.

Para obter detalhes sobre o Serverless Computing, consulte Visão geral do Serverless Computing. Para obter detalhes sobre virtual warehouses, consulte Introdução aos virtual warehouses.

Referência de parâmetros

O parâmetro computing_resource é opcional. Defina-o na cláusula WITH ao criar uma tabela dinâmica ou passe-o explicitamente durante uma atualização manual.

Parâmetro	Obrigatório	Padrão	Descrição	Exemplo
`computing_resource`	Não	`serverless` (V4.0.1+); `local` (V3.0)	Tipo de recurso para atualizar a tabela dinâmica. Valores aceitos: `local`, `serverless` ou `<warehouse_name>` (apenas V4.0.7+, somente instâncias de virtual warehouse).	`computing_resource='serverless'`

Sintaxe

V4.0.7 e posteriores

A versão V4.0.7 introduziu warehouse_name como valor válido, permitindo isolamento de recursos no nível do warehouse em instâncias de virtual warehouse. O significado de local também mudou: agora refere-se ao warehouse conectado atualmente, em vez do warehouse líder do grupo de tabelas (TG).

Crie uma tabela dinâmica com um recurso especificado:

-- Specify refresh resources when creating the table.
CREATE [EXTERNAL] DYNAMIC TABLE [ IF NOT EXISTS ] [<schema_name>.]<table_name>
  [ (<col_name> [, ...] ) ]
  [LOGICAL PARTITION BY LIST(<partition_key>)]
  WITH (
    freshness = '<num> {minutes | hours}', -- Required.
    [computing_resource = {'local' | 'serverless' | '<warehouse_name>'},] -- Optional.
  )
  AS
  <query>; -- Definition of the query.

Atualize manualmente com um recurso especificado:

-- Specify refresh resources during a manual refresh.
REFRESH DYNAMIC TABLE [<schema_name>.]<table_name>
  WITH (computing_resource = 'local' | 'serverless' | '<warehouse_name>');

V4.0.1 a V4.0.6

A versão V4.0.1 alterou o recurso de atualização padrão de local para serverless. O valor warehouse_name não é suportado neste intervalo.

Crie uma tabela dinâmica:

CREATE [EXTERNAL] DYNAMIC TABLE [ IF NOT EXISTS ] [<schema_name>.]<table_name>
  [ (<col_name> [, ...] ) ]
  [LOGICAL PARTITION BY LIST(<partition_key>)]
  WITH (
    freshness = '<num> {minutes | hours}', -- Required.
    [computing_resource = {'local' | 'serverless'},] -- Optional.
  )
  AS
  <query>; -- Definition of the query.

Atualize manualmente:

REFRESH DYNAMIC TABLE [<schema_name>.]<table_name>
  WITH ([computing_resource = 'local' | 'serverless']);

V3.1 a V3.2

A sintaxe e os padrões são os mesmos da V4.0.1–V4.0.6. O valor warehouse_name não é suportado.

Crie uma tabela dinâmica:

CREATE [EXTERNAL] DYNAMIC TABLE [ IF NOT EXISTS ] [<schema_name>.]<table_name>
  [ (<col_name> [, ...] ) ]
  [LOGICAL PARTITION BY LIST(<partition_key>)]
  WITH (
    freshness = '<num> {minutes | hours}', -- Required.
    [computing_resource = {'local' | 'serverless'},] -- Optional.
  )
  AS
  <query>; -- Definition of the query.

Atualize manualmente:

REFRESH DYNAMIC TABLE [<schema_name>.]<table_name>
  WITH ([computing_resource = 'local' | 'serverless']);

V3.0

A V3.0 usa uma sintaxe diferente com parâmetros separados para atualizações incrementais e completas, e tem como padrão os recursos local.

Crie uma tabela dinâmica:

CREATE DYNAMIC TABLE [IF NOT EXISTS] <schema.tablename>(
  [col_name],
  [col_name]
) [PARTITION BY LIST (col_name)]
WITH (
  [refresh_mode='[full|incremental]',]
  [incremental_auto_refresh_schd_start_time='[immediate|<timestamptz>]',]
  [incremental_auto_refresh_interval='[<num> {minute|minutes|hour|hours}]',]
  [incremental_guc_hg_computing_resource='[local|serverless]',]
  [full_guc_hg_computing_resource='[local|serverless]',]
)
AS
<query>; -- Definition of the query.

Atualize manualmente:

REFRESH DYNAMIC TABLE [<schema_name>.]<table_name>
  WITH (
    [incremental_guc_hg_computing_resource = 'local' | 'serverless',]
    [full_guc_hg_computing_resource = 'local' | 'serverless']
  );

Recursos de atualização padrão por versão

Padrões de atualização automática

V4.0.7 e posteriores

Tipo de tabela	Instância sem virtual warehouse	Instância de virtual warehouse
Tabela dinâmica	Serverless por padrão. É possível especificar `local` (recursos da instância).	Serverless por padrão. É possível especificar `warehouse_name`. Especificar `local` sem `warehouse_name` utiliza o warehouse da conexão atual.
Tabela dinâmica externa	Serverless por padrão. É possível especificar `local` (recursos da instância).	Serverless por padrão. É possível especificar `warehouse_name`. Especificar `local` sem `warehouse_name` utiliza o warehouse da conexão atual.

V4.0.1 a V4.0.6

Tipo de tabela	Instância sem virtual warehouse	Instância de virtual warehouse
Tabela dinâmica	Serverless por padrão. É possível especificar `local` (recursos da instância).	Serverless por padrão. `local` usa o warehouse líder do TG da tabela base e o warehouse líder do TG da tabela dinâmica — vários warehouses podem estar envolvidos. `warehouse_name` não é suportado.
Tabela dinâmica externa	Serverless por padrão. É possível especificar `local` (recursos da instância).	Serverless por padrão. `local` usa o warehouse líder do TG padrão no banco de dados onde a tabela dinâmica externa foi criada. `warehouse_name` não é suportado.

V3.1 a V3.2

Tipo de tabela	Instância sem virtual warehouse	Instância de virtual warehouse
Tabela dinâmica	Serverless por padrão. É possível especificar `local` (recursos da instância).	Serverless por padrão. `local` usa o warehouse líder do TG da tabela base e o warehouse líder do TG da tabela dinâmica — vários warehouses podem estar envolvidos. `warehouse_name` não é suportado.

V3.0

Tipo de tabela	Instância sem virtual warehouse	Instância de virtual warehouse
Tabela dinâmica	`local` por padrão. É possível especificar `serverless`.	`local` por padrão, usando o warehouse líder do TG da tabela dinâmica. É possível especificar `serverless`. `warehouse_name` não é suportado.

Prioridade de recursos na atualização manual

Ao acionar uma atualização manual, o recurso utilizado segue esta ordem de prioridade:

Valor definido explicitamente: Se você passar computing_resource na instrução REFRESH, esse valor terá efeito independentemente da Linguagem de Definição de Dados (DDL) da tabela.
Valor da DDL: Caso não passe computing_resource na instrução REFRESH, o sistema usará o valor da DDL da tabela.

Valores aceitos por tipo de instância (V4.0.7+):

Instância de virtual warehouse: local (warehouse conectado atualmente), serverless ou <warehouse_name>
Instância sem virtual warehouse: local (recursos da instância) ou serverless

Valores aceitos por tipo de instância (V4.0.1–V4.0.6 e V3.1–V3.2):

Instância de virtual warehouse: local ou serverless. local usa o warehouse líder do TG da tabela base e o warehouse líder do TG da tabela dinâmica — vários warehouses podem estar envolvidos.
Instância sem virtual warehouse: local (recursos da instância) ou serverless

V3.0:

Instância de virtual warehouse: local (warehouse líder do TG da tabela dinâmica) ou serverless
Instância sem virtual warehouse: local (recursos da instância) ou serverless

Observações de uso

Se você definir computing_resource como um warehouse_name e depois excluir esse virtual warehouse, a atualização falhará.
Se você definir computing_resource como um warehouse_name e depois renomear esse warehouse, a atualização continuará normalmente. O novo nome do warehouse aparecerá na DDL.
Se você definir computing_resource como serverless, mas a consulta da tabela dinâmica não atender às condições para execução serverless, a atualização retornará automaticamente aos recursos local: A DDL (visível via hg_dump_script) ainda mostrará computing_resource = 'serverless' após o fallback. Se a consulta posteriormente atender às condições de execução serverless, as atualizações seguintes usarão recursos serverless. Para verificar quais recursos foram realmente usados em uma atualização específica, consulte o log de consultas lentas.
- Em uma instância de virtual warehouse: local refere-se ao warehouse líder do TG onde a tabela dinâmica reside. Para uma tabela dinâmica externa, local refere-se ao warehouse padrão da instância.
- Em uma instância sem virtual warehouse: local refere-se aos recursos reservados da instância.

Observações sobre atualização de versão

As tabelas a seguir resumem como o comportamento dos recursos de atualização muda ao atualizar o Hologres. A principal diferença está entre as tabelas criadas com a nova sintaxe (V3.1+) e as tabelas que ainda usam a sintaxe legada da V3.0.

Alterações nos recursos de atualização automática ao atualizar

Versão de source	Versão de destino	Tipo de tabela	Instância sem virtual warehouse	Instância de virtual warehouse
3.0	3.1, 3.2 ou 4.0.1–4.0.6	Tabela dinâmica	Novas tabelas: O padrão muda de `local` para `serverless`. É possível definir `local`. Legacy V3.0 tables: O padrão permanece `local`. É possível alterar para `serverless`.	Novas tabelas: O padrão muda de `local` para `serverless`. É possível definir `local`; `local` usa o warehouse líder do TG da tabela base e o TG da tabela dinâmica (vários warehouses podem estar envolvidos). Tabelas legadas da V3.0: O padrão permanece `local` (warehouse líder do TG da tabela dinâmica). É possível alterar para `serverless`. Após atualizar para a nova sintaxe, `local` passa a incluir tanto o líder do TG da tabela base quanto o líder do TG da tabela dinâmica.
3.0	4.0.7 e posteriores	Tabela dinâmica	Novas tabelas: O padrão muda de `local` para `serverless`. É possível definir `local`. Legacy V3.0 tables: O padrão permanece `local`. É possível alterar para `serverless`.	Novas tabelas: O padrão muda de `local` para `serverless`. É possível especificar `warehouse_name`. `local` refere-se ao warehouse conectado atualmente. Tabelas legadas da V3.0: O padrão permanece `local` (warehouse líder do TG da tabela dinâmica). É possível alterar para `serverless`. Após atualizar para a nova sintaxe, `local` permanece como o warehouse líder do TG da tabela dinâmica.
3.1, 3.2 ou 4.0.1–4.0.6	4.0.7 e posteriores	Tabela dinâmica	Novas tabelas: O padrão permanece `serverless`. É possível definir `local`. Legacy V3.0 tables: O padrão permanece `local`. É possível alterar para `serverless`.	Novas tabelas: O padrão permanece `serverless`. É possível especificar `warehouse_name`. `local` refere-se ao warehouse conectado atualmente. Tabelas legadas da V3.0: O padrão permanece `local` (warehouse líder do TG da tabela dinâmica). É possível alterar para `serverless`. Após atualizar para a nova sintaxe, `local` muda de ambos (líder do TG da tabela base e líder do TG da tabela dinâmica) para apenas o líder do TG da tabela dinâmica.
4.0.1–4.0.6	4.0.7 e posteriores	Tabela dinâmica externa	Novas tabelas: O padrão permanece `serverless`. É possível definir `local`.	Novas tabelas: O padrão permanece `serverless`. É possível especificar `warehouse_name`. `local` refere-se ao warehouse conectado atualmente. Tabelas antigas (criadas na V4.0.1–4.0.6): O padrão permanece `serverless`. `local` usa o warehouse padrão da instância.

Alterações nos recursos de atualização manual ao atualizar

Versão de source	Versão de destino	Tipo de tabela	Instância sem virtual warehouse	Instância de virtual warehouse
3.0	3.1, 3.2 ou 4.0.1–4.0.6	Tabela dinâmica	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado.	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado. Para tabelas com nova sintaxe: `local` muda do líder do TG da tabela dinâmica para ambos: líder do TG da tabela base e líder do TG da tabela dinâmica (vários warehouses podem estar envolvidos). Para tabelas legadas da V3.0: `local` permanece como o líder do TG da tabela dinâmica.
3.0	4.0.7 e posteriores	Tabela dinâmica	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado. É possível especificar `local` ou `serverless`.	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado. É possível especificar `local`, `serverless` ou `warehouse_name`. Para tabelas com nova sintaxe: `local` muda para o warehouse conectado atualmente. Para tabelas legadas da V3.0: `local` permanece como o líder do TG da tabela dinâmica.
3.1, 3.2 ou 4.0.1–4.0.6	4.0.7 e posteriores	Tabela dinâmica	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado. É possível especificar `local` ou `serverless`.	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado. É possível especificar `local`, `serverless` ou `warehouse_name`. Para tabelas com nova sintaxe: `local` muda de ambos (líder do TG da tabela base e líder do TG da tabela dinâmica) para o warehouse conectado atualmente. Para tabelas legadas da V3.0: `local` permanece como o líder do TG da tabela dinâmica.
4.0.1–4.0.6	4.0.7 e posteriores	Tabela dinâmica externa	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado. É possível especificar `local` ou `serverless`.	O recurso explícito tem precedência. Sem configuração explícita, o valor da DDL é usado. É possível especificar `local`, `serverless` ou `warehouse_name`. `local` refere-se ao warehouse conectado atualmente.