Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Mude de serviço usando a lista suspensa de Versões . Saiba mais sobre navegação.
Aplica-se a: ✅ Microsoft Fabric ✅ Azure Data Explorer
Desativa ou possibilita o processo de materialização para uma visão materializada.
Observação
Como existem algumas implicações importantes de desempenho associadas a desativar/ativar uma visualização materializada, certifique-se de que está familiarizado com elas antes de avançar com a utilização deste comando. Para mais informações, consulte a secção Implicações de Desempenho de ativar/desativar vistas materializadas .
Permissions
Tens de ter pelo menos o Materialized View Admin para executar estes comandos.
Sintaxe
.enable
|
disable
materialized-view
MaterializedViewName
Saiba mais sobre convenções de sintaxe.
Parâmetros
| Nome | Tipo | Obrigatório | Description |
|---|---|---|---|
| MaterializedViewName | string |
✔️ | Nome da vista materializada. |
Devoluções
Se a visualização materializada já estiver no estado em que o comando tenta defini-la, o comando falha com um erro que indica que é esse o caso.
Caso contrário, devolve os detalhes sobre a visualização materializada cuja propriedade IsEnabled foi alterada.
Esquema de saída:
| Nome | Tipo | Description |
|---|---|---|
| Nome | string |
Nome da vista materializada. |
| Tabela de fontes | string |
Nome da tabela de origem na qual o modo de exibição está definido. |
| Query | string |
Definição de consulta da vista materializada. |
| MaterializedTo | datetime |
Hora máxima materializada ingestion_time() na tabela de código-fonte. Para mais informações, veja como funcionam as visualizações materializadas. |
| LastRun | datetime |
Da última vez que a materialização foi feita. |
| LastRunResult | string |
Resultado da última tentativa. Retornos Completed para corridas bem-sucedidas, caso contrário Failed. |
| IsHealthy | bool |
true quando a visão é considerada saudável, false caso contrário. A vista é considerada saudável se foi materializada com sucesso até à última hora (MaterializedTo é maior que ago(1h)). |
| Está Ativado | bool |
true quando a visualização está ativada (ver Desativar ou ativar a visualização materializada). |
| Folder | string |
Pasta sob a qual a visualização materializada é criada. |
| DocString | string |
Descrição atribuída à vista materializada. |
| AutoUpdateSchema | bool |
Se a visualização está ativada para atualizações automáticas. |
| EffectiveDateTime | datetime |
Data efetiva da hora da visualização, determinada durante o momento da criação (ver .create materialized-view). |
| Olhar para trás | timespan |
O período de tempo que limita o período durante o qual são esperadas duplicações ou atualizações. Para obter mais informações, consulte Período de retrospetiva. |
| Coluna de Retrospecto | string |
Uma string coluna na vista que serve de referência para o período de retrospetiva. Se esta coluna estiver vazia, mas tiver lookback um valor, a vista materializada utilizará um retrovisor predefinido. Para obter mais informações, consulte Período de retrospetiva. |
Examples
Permitir uma visualização materializada
O seguinte comando permite a visualização materializada do ViewName:
.enable materialized-view ViewName
Output
| Nome | Tabela de fontes | Query | MaterializedTo | LastRun | LastRunResult | IsHealthy | Está Ativado | Folder | DocString | AutoUpdateSchema | EffectiveDateTime | Olhar para trás |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ViewName | TableName | Nome da Tabela | resumir arg_max(Coluna 3, *) por Coluna 1 | 2023-02-26T16:40:03.3345704Z | 2023-02-26T16:44:15.9033667Z | Concluído | true | true | false | 2023-02-23T14:01:42.5172342Z |
Desativar uma visualização materializada
O seguinte comando desativa a visualização materializada ViewName:
.disable materialized-view ViewName
Output
| Nome | Tabela de fontes | Query | MaterializedTo | LastRun | LastRunResult | IsHealthy | Está Ativado | Folder | DocString | AutoUpdateSchema | EffectiveDateTime | Olhar para trás |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ViewName | TableName | Nome da Tabela | resumir arg_max(Coluna 3, *) por Coluna 1 | 2023-02-26T16:40:03.3345704Z | 2023-02-26T16:44:15.9033667Z | Concluído | true | false | false | 2023-02-23T14:01:42.5172342Z |
Observações
Visualizações materializadas incapacitantes
Uma visualização materializada pode ser desativada de qualquer uma das seguintes formas:
-
Desativação automática pelo sistema: A visualização materializada é automaticamente desativada se a materialização falhar com um erro permanente. Este processo pode ocorrer nas seguintes ocasiões:
- Alterações de esquema que são inconsistentes com a definição da vista.
- Alterações na tabela de origem que resultam na consulta da visualização materializada semanticamente inválida.
-
Desabilite explicitamente a visualização materializada: Se a visualização materializada estiver a afetar negativamente a saúde da base de dados (por exemplo, consumindo demasiado CPU), desative a visualização usando o
.disable materialized-viewcomando.
Vistas materializadas e Segurança ao Nível de Fila
Se uma visualização materializada estiver desativada, e enquanto a vista estiver desativada, alguém define uma política de segurança ao nível da linha na tabela de origem da vista, mas a visualização materializada não tiver uma política de segurança ao nível da linha definida, então ativar a vista falha por razões de segurança. Para mitigar este erro, pode:
- Defina a política de segurança ao nível da linha sobre a visualização materializada.
- Escolha ignorar o erro adicionando
allowMaterializedViewsWithoutRowLevelSecurityuma propriedade ao comando de ativar política. Por exemplo:
.enable materialized-view MV with (allowMaterializedViewsWithoutRowLevelSecurity=true)
Implicações de desempenho de habilitar/desativar vistas materializadas
- Quando uma visualização materializada é desativada, a materialização será pausada e não consome recursos da base de dados. Consultar a visualização materializada é possível mesmo quando desativada, mas o desempenho pode ser fraco. O desempenho numa visualização materializada desativada depende do número de registos que foram ingeridos na tabela de origem desde que esta foi desativada.
- Pode ativar uma visualização materializada que já foi desativada. Quando reativada, a visualização materializada continuará a materializar-se a partir do ponto em que ficou, e nenhum registo será ignorado. Se a vista esteve desativada durante muito tempo, pode demorar muito tempo a recuperar.
- Desativar uma visualização só é recomendado se suspeitar que a visualização está a afetar a saúde da sua base de dados.