Atualizar a atividade do endpoint de análise SQL

A atividade de atualização do ponto final de análise SQL nos pipelines do Microsoft Fabric permite-lhe atualizar programaticamente o ponto final de análise SQL de um Lakehouse no âmbito de um fluxo de trabalho orquestrado. Faz parte da Lakehouse Utility Suite para oleodutos e é normalmente utilizada após a atividade de Manutenção da Lakehouse (por exemplo, após operações OPTIMIZE ou VACUUM). Os consumidores a jusante — como relatórios Power BI, cadernos ou clientes SQL externos — passam a ver os dados mais recentes após a conclusão das etapas de preparação ou manutenção dos dados.

Utilize esta atividade para fazer com que os endpoints de análise SQL reflitam imediatamente as atualizações recentes, sem depender de atualizações manuais ou processos ad hoc. Use esta atividade quando o seu pipeline:

• Atualiza ou mantém os dados do Lakehouse (por exemplo, após Copy Jobs, execução do Notebook ou atividades de manutenção do Lakehouse).
• Exige que o endpoint de análise SQL do Lakehouse reflita os últimos metadados e alterações nos dados.
• É necessário um tempo determinístico de atualização antes de etapas posteriores como relatórios, análises ou exportações.

Pré-requisitos

Antes de usar esta atividade, certifique-se de que:

• Uma conta de locatário com uma assinatura ativa. Crie uma conta gratuitamente.
• Um espaço de trabalho com uma Casa do Lago
• Existe um endpoint de análise SQL para o Lakehouse.
• A identidade do pipeline (utilizador ou principal de serviço) tem permissão para atualizar o endpoint de análise SQL.

Adicione uma atividade de atualização do endpoint de análise SQL ao seu pipeline na interface de utilizador

1. Crie um novo pipeline no seu espaço de trabalho.

2. Pesquise por Atualizar ponto final de análise SQL no painel Atividades do pipeline e selecione-o para o adicionar à tela de desenho do pipeline.

   

3. Selecione a nova atividade Atualizar ponto final de análise SQL na área de desenho, caso ainda não esteja selecionada.

   

   Sugestão

   Pode orquestrar esta atividade juntamente com outras atividades do Lakehouse Utility Suite — como a atividade de Manutenção do Lakehouse — no mesmo pipeline, para que a manutenção e a atualização corram em sequência.

4. Consulte as orientações gerais de configuração para configurar o separador Configurações Gerais.

Atualizar as definições de atividade do endpoint de análise SQL

1. Selecione o separador Definições para configurar a atividade.  

2. Configure a ligação selecionando uma ligação existente da lista pendente Ligações, ou criando uma nova ligação e especificando os seus detalhes de configuração.

3. Especifique o Espaço de Trabalho que contém a Casa do Lago.

4. Especificar o ponto final de análise SQL como o ID do ponto final de análise SQL do Lakehouse que pretende atualizar. A atualização atualiza os metadados do endpoint de análise SQL do Lakehouse para que reflitam os dados recentes e alterações no esquema.

   

Comportamento de atividade

Quando a execução da atividade terminar:

• Se o pop-up de Saída mostrar o estado de Sucesso , o pedido sincroniza com sucesso os dados não sincronizados.

  

• Um estado NotRun no pop-up Output significa que a atualização do endpoint de análise SQL não foi executada. Essa condição normalmente significa que não adicionaste novos dados desde a última sincronização, por isso não precisaste de os executar.

  

• Se o pop-up de Saída mostrar o estado como Falha, algo correu mal.

Cenários comuns

• Atualização do endpoint de análise SQL após um Notebook escrever dados transformados num Lakehouse.
• Desencadeie uma atualização do endpoint de análise SQL após a conclusão da atividade de Manutenção Lakehouse (OPTIMIZE ou VACUUM).
• Garantir que os relatórios e dashboards consultam o estado mais recente de Lakehouse em pontos bem definidos de um pipeline.

Porque é que a atualização do meu endpoint de análise SQL falha quando os dados subjacentes estão bloqueados?

A atividade de atualização do endpoint de análise SQL pode falhar intermitentemente quando outros processos atualizam ativamente os dados subjacentes do Lakehouse. Estes processos incluem pipelines de ingestão, notebooks ou operações de escrita concorrentes.

Esta falha acontece porque o endpoint de análise SQL precisa de adquirir bloqueios internos para completar a atualização. Se outra operação bloquear os dados, o pedido expira ou devolve um erro.

Este comportamento é esperado com base na forma como os endpoints de análise SQL gerem as operações de atualização de metadados.

Sintomas

• A atividade falha intermitentemente, não de forma consistente.
• Mensagens de erro indicam conflitos de atualização ou contenção de bloqueios.
• Pipelines com múltiplas atividades sequenciais de atualização do SQL analytics endpoint apresentam taxas de falha mais elevadas.

Causa raiz

Os endpoints de análise SQL requerem acesso exclusivo a certas estruturas de metadados durante a atualização. Se outro processo de computação escrever no Lakehouse ao mesmo tempo, ocorre contenção de bloqueio.

Este comportamento não é uma falha na atividade de atualização do ponto final de análise de SQL. É o resultado natural de operações simultâneas de leitura e escrita sobre os dados subjacentes.

Soluções

Duas abordagens práticas podem mitigar este problema:

• Utilize apenas uma atividade de atualização do ponto final do SQL Analytics no final do processamento
• Implemente um calendário de atualizações recorrentes

Utilize apenas uma atividade de atualização do ponto final de análise SQL no final do processamento

Para reduzir a probabilidade de conflitos de bloqueio, organize o seu pipeline de modo a que:

• Todas as atividades de ingestão, transformação e atualização são executadas primeiro,
• Depois, apenas uma atividade de atualização do endpoint SQL Analytics é executada no final.
• Esta abordagem não elimina completamente as falhas, mas reduz significativamente a frequência com que ocorrem.

Implemente um calendário de atualizações recorrentes

Se o seu cenário não exigir consistência transacional estrita num momento específico, adote um padrão de atualização recorrente:

• Marque uma atualização a cada 15 minutos — continuamente. Algumas tentativas de atualização podem falhar devido ao bloqueio, mas têm sucesso suficiente para manter o endpoint de SQL Analytics relativamente atualizado.

Esta abordagem é prática e robusta para muitas cargas de trabalho analíticas.

Guardar e executar ou programar o pipeline

Altere para o separador Início no topo do editor de pipeline e selecione o botão de guardar para salvar o seu pipeline. Selecione Executar para executar diretamente ou Agendar para agendar corridas em horários ou intervalos específicos. Para obter mais informações sobre execuções de pipeline, consulte: agendar execuções de pipeline.

Depois de executar, podes monitorizar a execução do pipeline e ver o histórico de execuções a partir do separador Output abaixo da tela.

Problemas conhecidos

• A atividade de atualização do ponto final de análise SQL pode falhar de forma intermitente quando outros processos atualizam ativamente os dados subjacentes no Lakehouse. Para soluções alternativas, veja Porque é que a atualização do meu endpoint de análise SQL falha quando os dados subjacentes estão bloqueados?

Conteúdo relacionado

• Atividade de manutenção do Lakehouse
• Atualize os metadados dos endpoints de análise SQL com a API REST