Adicionar o SQL Server na origem do banco de dados (CDA) da VM a um Eventstream

Este artigo mostra como adicionar um SQL Server em uma VM como fonte de CDC (Captura de Dados de Alteração) a um fluxo de eventos.

O conector de origem do SQL Server na VM DB (CDC) para fluxos de eventos do Fabric permite capturar um instantâneo dos dados atuais em um banco de dados do SQL Server na VM. Atualmente, o SQL Server no CDC (VM DB) tem suporte nos seguintes serviços em que os bancos de dados podem ser acessados publicamente:

• SQL Server em Máquinas Virtuais do Azure
• Amazon RDS para SQL Server
• Amazon RDS Personalizado para SQL Server
• SQL do Google Cloud para SQL Server

Depois que a origem do SQL Server na VM DB (CDC) for adicionada ao fluxo de eventos, ela monitorará e registrará futuras alterações no nível de linha, que podem ser processadas em tempo real e enviadas para vários destinos para análise posterior.

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 SQL Server em execução no banco de dados da VM.
• Seu SQL Server no banco de dados da VM deve ser configurado para permitir o acesso público.
• Habilite a CDA em seu SQL Server no banco de dados da VM executando o procedimento armazenado sys.sp_cdc_enable_db. Para obter detalhes, confira Habilitar e desabilitar a captura de dados de alterações.

Habilitar a CDA no SQL Server no banco de dados da VM

1. Habilite a CDA para o banco de dados.

   EXEC sys.sp_cdc_enable_db; 
   

2. 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 for executada com êxito, você habilitou a CDA no SQL Server no banco de dados da VM.

   

Adicionar o SQL Server no banco de dados da VM como uma origem

1. Na Inteligência em Tempo Real do Fabric, selecione Eventstream para criar um eventstream.

   

2. Na tela seguinte, selecione Adicionar origem externa.

   

Configurar e conectar-se ao SQL Server no banco de dados da VM

1. Na página Conectar, selecione Nova conexão.

   

2. Na seção Configurações de conexão, insira os seguintes valores para o SQL Server na VM:

   • Servidor: insira o endereço IP ou o nome de domínio acessível publicamente da VM e adicione dois-pontos e a porta. Por exemplo, se o endereço IP for xx.xxx.xxx.xxx e a porta for 1433, você deverá entrar xx.xxx.xxx.xxx:1433 no campo Servidor. Se a porta não for especificada, o valor da porta padrão 1433 será usado.

   • Banco de dados: insira o nome do banco de dados ao qual você deseja se conectar no SQL Server na VM.

     

3. 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.

     Observação

     Não selecione a opção: use a conexão criptografada.

     

4. Na parte inferior da página, selecione Conectar.

5. 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. O limite total de caracteres para toda a entrada é de 102.400 caracteres .

6. 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.

7. Selecione Avançar.

   

8. Na tela Examinar e conectar, examine o resumo e selecione Conectar.

   

Exibir o Eventstream atualizado

É possível visualizar o SQL Server na origem da CDA do banco de dados da VM adicionada ao Eventstream no modo Editar.

Para implementar esse SQL Server recém-adicionado na origem da CDA do banco de dados da VM, selecione Publicar. Ao concluir essas etapas, o SQL Server no origem da CDA do banco de dados da VM estará disponível para visualização no modo de Exibição ao vivo.

Conteúdo relacionado

Outros conectores:

• Fluxos de dados do Amazon Kinesis
• Azure Cosmos DB
• Hubs de eventos do Azure
• Hub IoT do Azure
• Captura de dados de alterações (CDA) com o Banco de Dados SQL do Azure
• Kafka para Confluent
• Ponto de extremidade personalizado
• Pub/Sub do Google Cloud
• CDA do Banco de dados PostgreSQL
• Dados de amostra
• Eventos de Armazenamento de Blobs do Azure
• Evento de espaço de trabalho do Fabric