Adicionar a fonte de CDA da Instância Gerenciada de SQL do Azure a um Eventstream

2025-06-05

Este artigo mostra como adicionar uma fonte de CDA (Captura de Dados de Alterações) da Instância Gerenciada de SQL do Azure a um Eventstream.

O conector de origem CDC da Instância Gerenciada de SQL do Azure para fluxos de eventos do Microsoft Fabric permite capturar um instantâneo dos dados atuais em um banco de dados da Instância Gerenciada de SQL. Em seguida, o conector monitora e registra quaisquer alterações futuras no nível da linha nesses dados. Depois que as alterações forem capturadas no eventstream, você poderá processar esses dados da CDA em tempo real e enviá-los a diferentes destinos no Fabric para processamento ou análise adicionais.

Observação

Não há suporte para esta origem nas seguintes regiões de capacidade do espaço de trabalho: Oeste dos EUA 3 e Oeste da Suíça.

Pré-requisitos

Acesso a um espaço de trabalho no modo de licença de capacidade do Fabric (ou) no modo de licença de Avaliação com permissões de Colaborador ou superior.
Um banco de dados da Instância Gerenciada de SQL do Azure em execução.
A Instância Gerenciada de SQL do Azure deve habilitar o ponto de extremidade público e não deve estar protegida por um firewall ou uma rede virtual.
CDA habilitada na Instância Gerenciada de SQL do Azure executando o procedimento armazenado sys.sp_cdc_enable_db. Para obter detalhes, confira Habilitar e desabilitar a captura de dados de alterações.

Habilitar o ponto de extremidade público na sua instância gerenciada de SQL do Azure

Acesse o portal do Azure, abra a instância gerenciada de SQL do Azure, selecione Rede e habilite o ponto de extremidade público.

Habilitar a CDA na sua instância gerenciada de SQL do Azure

Habilite a CDA para o banco de dados.
```
EXEC sys.sp_cdc_enable_db; 
```
Habilite a CDA para uma tabela usando uma opção de função gating. Neste exemplo, MyTable é o nome da tabela SQL.
```
EXEC sys.sp_cdc_enable_table 
   @source_schema = N'dbo', 
   @source_name   = N'MyTable', 
   @role_name     = NULL 
GO 
```
Depois que a consulta foi executada, você habilitou a CDA na sua instância gerenciada de SQL do Azure.

Adicionar a CDA da Instância Gerenciada de SQL do Azure como fonte

Na Inteligência em Tempo Real do Fabric, selecione Eventstream para criar um eventstream.
Na tela seguinte, selecione Adicionar origem externa.

Configurar e conectar-se à CDA da Instância Gerenciada de SQL do Azure

Na página Conectar, selecione Nova conexão.
Na seção Configurações de conexão, insira os seguintes valores para o SQL Server na VM:
- Servidor: insira o Ponto de Extremidade no portal do Azure, substituindo a vírgula entre o host e a porta por dois-pontos. Por exemplo, se o Ponto de Extremidade for xxxxx.public.xxxxxx.database.windows.net,3342, insira xxxxx.public.xxxxxx.database.windows.net:3342 no campo Servidor.
- Banco de dados: insira o nome do banco de dados ao qual você deseja se conectar dentro da Instância Gerenciada de SQL do Azure.
Role para baixo e, na seção Credenciais de conexão, siga as etapas a seguir.
- Em Nome da conexão, insira um nome para a conexão.
- Em Variante de autenticação, selecione Básico.
  
  Observação
  
  Atualmente, os fluxos de eventos do Fabric são compatíveis apenas com a autenticação Básica.
- Insira nome de usuário e senha para o SQL Server na VM.
Na parte inferior da página, selecione Conectar.
Agora, na página Conectar, selecioneTodas as tabelas ou Insira os nomes da tabela. Se você selecionar o último, especifique tabelas usando uma lista separada por vírgulas de identificadores de tabela completos (schemaName.tableName) ou expressões regulares válidas. Por exemplo:
- Use dbo.test.* para selecionar todas as tabelas cujos nomes começam com dbo.test.
- Use dbo\.(test1|test2) para selecionar dbo.test1 e dbo.test2.
Você pode misturar ambos os formatos usando vírgulas. Até 100 tabelas podem ser inseridas, com cada nome de tabela (incluindo o nome do esquema) limitado a 128 caracteres se estiver usando identificadores de tabela completos diretamente.
Você pode expandir as configurações avançadas para configurar o modo de tratamento Decimal, que especifica como o conector manipula DECIMAL e NUMERIC valores de coluna:
- Precise: representa valores usando tipos decimais exatos (por exemplo, Java BigDecimal) para garantir a precisão total e a precisão na representação de dados.
- Double: converte valores em números de ponto flutuante de precisão dupla. Isso melhora a usabilidade e o desempenho, mas pode resultar em uma perda de precisão.
- String: codifica valores como cadeias de caracteres formatadas. Isso facilita o consumo em sistemas downstream, mas perde informações semânticas sobre o tipo numérico original.
Selecione Avançar.
Na página Examinar e conectar, examine o resumo e selecione Conectar.

Exibir o Eventstream atualizado

Você pode ser a fonte do banco de dados MI SQL do Azure (CDA) adicionada ao Eventstream no modo de Edição.

Para implementar essa fonte da Instância Gerenciada de SQL do Azure recém-adicionada, selecione Publicar. Ao concluir essas etapas, a fonte da Instância Gerenciada de SQL do Azure estará disponível para visualização no modo de Exibição ao vivo.

Outros conectores:

Compartilhar via