Partilhar via


Adicionar o SQL Server na origem VM DB (CDC) a um fluxo de eventos

Este artigo mostra como adicionar uma fonte CDC (Change Data Capture) do SQL Server on VM DB a um fluxo de eventos.

O conector de origem do SQL Server on 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 em VM DB (CDC) é suportado pelos seguintes serviços onde os bancos de dados podem ser acessados publicamente:

Nota

O AWS RDS SQL Server, o AWS RDS Custom SQL Server e o Google Cloud SQL Server não são compatíveis com a versão Express. Verifique se você está usando uma edição apropriada do SQL Server para CDC.

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

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 teste, com permissões de Colaborador ou superiores.
  • Um SQL Server em execução no banco de dados VM.
  • Seu banco de dados SQL Server em VM deve ser configurado para permitir acesso público.
  • Habilite o CDC em seu banco de dados SQL Server on VM executando o procedimento sys.sp_cdc_enable_dbarmazenado . Para obter detalhes, consulte Habilitar e desabilitar a captura de dados de alteração.

Habilitar CDC em seu banco de dados SQL Server on VM

  1. Ativar o CDC para o banco de dados.

    EXEC sys.sp_cdc_enable_db; 
    
  2. Ative o CDC para uma tabela usando uma opção de função de controlo de acesso. 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 o CDC no banco de dados do SQL Server na VM.

    Uma captura de tela mostrando que o CDC está ativado.

Adicionar o SQL Server no banco de dados VM como origem

  1. Em Fabric Real-Time Intelligence, selecione Eventstream para criar um novo eventstream.

    Uma captura de tela da criação de um novo fluxo de eventos.

  2. Na tela seguinte, selecione Adicionar fonte externa.

    Uma captura de tela mostrando a seleção Adicionar fonte externa.

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

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

    Captura de tela que mostra a seleção do link Nova conexão na página Conectar.

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

    • Servidor: introduza o endereço IP ou o nome de domínio publicamente acessível da sua VM e, em seguida, adicione uma vírgula e a porta. Por exemplo, se o seu endereço IP é xx.xxx.xxx.xxx e a porta é 1433, então você deve entrar xx.xxx.xxx.xxx:1433 no campo Servidor . Se a porta não for especificada, o valor 1433 da porta padrão será usado.

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

      Captura de ecrã que mostra a secção Configurações de Conexão da página de Conexão.

  3. Role para baixo e, na seção Credenciais de conexão, siga estas etapas.

    • Em Nome da conexão, insira um nome para a conexão.

    • Em Tipo de autenticação, selecione Básico.

      Nota

      Atualmente, os fluxos de eventos do Fabric oferecem suporte apenas à autenticação Básica .

    • Digite nome de usuário e senha para o SQL Server na VM.

      Nota

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

      Captura de ecrã que mostra a secção das Credenciais de ligação da página de ligação.

  4. Selecione Conectar na parte inferior da página.

  5. Agora, na página Connect, selecione Todas as tabelas ou Introduza o(s) nome(s) da(s) tabela(s). 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 comecem 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 Manipulação Decimal, especificando como o conector lida com os valores das colunas DECIMAL e NUMERIC.

    • Precise: Representa valores usando tipos decimais exatos (por exemplo, Java BigDecimal) para garantir total precisão e precisão na representação de dados.
    • Double: Converte valores em números de vírgula 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 os torna fáceis de consumir em sistemas a jusante, mas perde informações semânticas sobre o tipo numérico original.
  7. Selecione Seguinte.

    Captura de tela que mostra a seleção da opção Todas as tabelas.

  8. Na tela de Revisão + criação, reveja o resumo e, em seguida, selecione Conectar.

    Captura de tela que mostra a seleção do botão Adicionar.

Ver fluxo de eventos atualizado

Você pode ver o SQL Server na fonte VM DB CDC adicionado ao seu fluxo de eventos no modo de edição .

Uma captura de tela do SQL Server adicionado na fonte VM DB CDC no modo de edição com o botão Publicar realçado.

Para implementar esse SQL Server recém-adicionado na origem VM DB CDC, selecione Publicar. Depois de concluir essas etapas, a sua fonte CDC do SQL Server em VM DB fica disponível para visualização na Vista ao vivo.

Uma captura de tela do SQL Server adicionado na fonte VM DB CDC no modo de exibição dinâmica.

Outros conectores: