Partilhar via


.criar ou alterar exportação contínua

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

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

Permissões

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

Sintaxe

.create-or-alter continuous-export continuousExportName [over(T1, T2)] totableexternalTableName [with(propertyName=propertyValue [, ...])] <|consulta

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
contínuoExportName string ✔️ O nome da exportação contínua. Deve ser exclusivo dentro do banco de dados.
externalTableName string ✔️ O nome da tabela externa destino de exportação.
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 de 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 representação autenticaçã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ínuo.

Propriedades suportadas

Propriedade Tipo Descrição
intervalBetweenRuns Timespan O intervalo de tempo entre execuções de exportação contínuas. Deve ter mais de 1 minuto.
forcedLatency Timespan Um período de tempo opcional para limitar a consulta a registros ingeridos antes de um período especificado em relação à hora atual. Essa propriedade é útil se, por exemplo, a consulta executar algumas agregações ou junções e você quiser certificar-se de que 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 Desative ou habilite a exportação distribuída. Definir como false é equivalente a single dica de distribuição. O padrão é true.
parquetRowGroupSize int Relevante apenas quando o formato de dados é Parquet. Controla o tamanho do grupo de linhas nos arquivos exportados. O tamanho padrão do grupo de linhas é 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ínuo.
isDisabled bool Desative ou habilite a exportação contínua. O padrão é false.

Exemplo

O exemplo a seguir cria ou altera uma 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
Designação ExternalTableName Consulta Latência forçada IntervalBetweenRuns CursorScopedTables ExportPropriedades
MyExport Blob Externo S 00:10:00 01:00:00 [
"['DB']. ['S']"
]
{
"SizeLimit": 104857600
}