Compartilhar via

.create ou alter continuous-export

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

Cria ou altera um trabalho de exportação contínua.

Permissões

Você deve ter pelo menos permissões de administrador de banco de dados para executar esse comando.

Sintaxe

.create-or-alter continuous-export nome_da_exportação contínua [over(T1, T2)] totable nome_da_tabela externa [with( nome_da_propriedade valor_da_=propriedade [, ...]])<|consulta

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatória Descrição
continuousExportName string ✔️ O nome da exportação contínua. Deve ser exclusivo no banco de dados.
nome_da_tabela_externa string ✔️ O nome do destino de exportação da tabela externa.
consulta string ✔️ A consulta a ser exportada.
T1, T2 string Uma lista separada por vírgulas de tabelas de fatos na consulta. Se não for especificado, todas as tabelas referenciadas na consulta serão consideradas tabelas de fatos. Se especificado, as tabelas não nesta lista são tratadas como tabelas de dimensão e não têm escopo, portanto, todos os registros participam de todas as exportações. Consulte a visão geral da exportação contínua de dados para obter detalhes.
propertyName, propertyValue string Uma lista separada por vírgulas de propriedades opcionais.

Observação

Se a tabela externa de destino usar autenticação de representação , você deverá especificar uma identidade gerenciada para executar a exportação contínua. Para obter mais informações, consulte Usar uma identidade gerenciada para executar um trabalho de exportação contínua.

Propriedades aceitas

Propriedade Tipo Descrição
intervalBetweenRuns Timespan O intervalo de tempo entre as execuções de exportação contínua. Deve ser maior que 1 minuto.
forcedLatency Timespan Um período opcional de tempo para limitar a consulta aos registros ingeridos antes de um período especificado em relação à hora atual. Essa propriedade será útil se, por exemplo, a consulta executar algumas agregações ou junções e você quiser verificar se todos os registros relevantes foram ingeridos antes de executar a exportação.
sizeLimit long O limite de tamanho em bytes de um único artefato de armazenamento gravado antes da compactação. Intervalo válido: 100 MB (padrão) a 1 GB.
distributed bool Desabilite ou habilite a exportação distribuída. Definir como false é equivalente a dica de single distribuição. O padrão é true.
distribution string Dica de distribuição (single, per_node, per_shard). Veja mais detalhes nas configurações de distribuição. O padrão é per_node
distributionKind string Opcionalmente, alterna para distribuição uniforme quando a tabela externa é particionada por partição de cadeia de caracteres. Os valores válidos são uniform ou default. Veja mais detalhes nas configurações de distribuição
parquetRowGroupSize int Relevante somente quando o formato de dados é Parquet. Controla o tamanho do grupo de linhas nos arquivos exportados. O tamanho padrão do grupo de linhas é de 100.000 registros.
managedIdentity string A identidade gerenciada para a qual o trabalho de exportação contínua é executado. A identidade gerenciada pode ser uma ID de objeto ou a palavra reservada system . Para obter mais informações, consulte Usar uma identidade gerenciada para executar um trabalho de exportação contínua.
isDisabled bool Desabilite ou habilite a exportação contínua. Padrão é false
Propriedade Tipo Descrição
intervalBetweenRuns Timespan O intervalo de tempo entre as execuções de exportação contínua. Deve ser maior que 1 minuto.
forcedLatency Timespan Um período opcional de tempo para limitar a consulta aos registros ingeridos antes de um período especificado em relação à hora atual. Essa propriedade será útil se, por exemplo, a consulta executar algumas agregações ou junções e você quiser verificar se todos os registros relevantes foram ingeridos antes de executar a exportação.
sizeLimit long O limite de tamanho em bytes de um único artefato de armazenamento gravado antes da compactação. Intervalo válido: 100 MB (padrão) a 1 GB.
distributed bool Desabilite ou habilite a exportação distribuída. Definir como false é equivalente a dica de single distribuição. O padrão é true.
distribution string Dica de distribuição (single, per_node, per_shard). Veja mais detalhes nas configurações de distribuição. O padrão é per_node
distributionKind string Opcionalmente, alterna para distribuição uniforme quando a tabela externa é particionada por partição de cadeia de caracteres. Os valores válidos são uniform ou default. Veja mais detalhes nas configurações de distribuição
parquetRowGroupSize int Relevante somente quando o formato de dados é Parquet. Controla o tamanho do grupo de linhas nos arquivos exportados. O tamanho padrão do grupo de linhas é de 100.000 registros.
isDisabled bool Desabilite ou habilite a exportação contínua. Padrão é false

Exemplo

O exemplo a seguir cria ou altera um MyExport de exportação contínua que exporta dados da tabela T para ExternalBlob. As exportações de dados ocorrem a cada hora e têm uma latência forçada definida e um limite de tamanho por artefato de armazenamento.

.create-or-alter continuous-export MyExport
over (T)
to table ExternalBlob
with
(intervalBetweenRuns=1h, 
 forcedLatency=10m, 
 sizeLimit=104857600)
<| T
Nome Nome_da_tabela_externa Consulta Latência forçada IntervaloEntreCorridas CursorScopedTables ExportProperties
Minha exportação Blob externo S 00:10:00 01:00:00 [
"['DB']. ['S']"
]		 {
"SizeLimit": 104857600
}

Conteúdo relacionado

  • Last updated on