Partilhar via


Adicionar CDC de banco de dados (DB) da Instância Gerenciada SQL (MI) do Azure como origem no hub em tempo real

Este artigo descreve como adicionar o Azure SQL Managed Instance CDC como uma fonte de eventos no hub Fabric Real-Time.

O conector de origem CDC do Azure SQL Managed Instance permite obter um instantâneo dos dados presentes num banco de dados da Instância Gerenciada SQL. Em seguida, o conector monitoriza e regista quaisquer alterações futuras ao nível da linha nesses dados. Depois que as alterações forem capturadas no fluxo de eventos, você poderá processar esses dados CDC em tempo real e enviá-los para diferentes destinos no Fabric para processamento ou análise adicionais.

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 banco de dados de Instância Gerenciada SQL do Azure em execução.
  • A sua Instância Gerenciada SQL do Azure deverá ter o ponto de extremidade público ativado e não deverá estar atrás de um firewall nem protegido por uma rede virtual.
  • CDC ativado na sua Instância Gerida do SQL do Azure ao executar o procedimento armazenado sys.sp_cdc_enable_db. Para obter detalhes, consulte Habilitar e desabilitar a captura de dados de alteração.

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

Vá para o portal do Azure, abra sua instância gerenciada SQL do Azure, selecione Rede e habilite o ponto de extremidade público.

Captura de ecrã que mostra a página de Redes com a opção Ponto de Extremidade Público ativada.

Habilite o CDC em sua instância gerenciada SQL do Azure

  1. Habilite o CDC para o banco de dados.

    EXEC sys.sp_cdc_enable_db; 
    
  2. Habilite o CDC para uma tabela usando uma opção de função de bloqueio. 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 em sua instância gerenciada do SQL do Azure.

Obter eventos da Instância Gerenciada SQL do Azure (CDC)

Você pode obter eventos de um CDC de Banco de Dados (DB) da Instância Gerenciada SQL (MI) do Azure para o hub em Tempo Real de uma das maneiras:

Página de origens de dados

  1. Inicie sessão no Microsoft Fabric.

  2. Se vires Power BI no canto inferior esquerdo da página, alterna para a carga de trabalho de Fabric ao selecionares Power BI e depois selecionares Fabric.

    Captura de ecrã que mostra como mudar para a carga de trabalho do Fabric.

  3. Selecione Tempo Real na barra de navegação esquerda.

    Captura de tela que mostra como iniciar a experiência Conectar à fonte de dados.

  4. Na página do Centro em Tempo Real, selecione + Fontes de dados sob Conectar a no menu de navegação à esquerda.

    Captura de tela que mostra a página Fontes de dados no hub Real-Time.

    Você também pode acessar a página de Fontes de dados a partir das páginas de Todos os fluxos de dados ou Meus fluxos de dados ao selecionar o botão + Conectar fonte de dados no canto superior direito.

    Captura de tela que mostra o botão Conectar fonte de dados.

  1. Na página Fontes de Dados, selecione a categoria Database CDC no topo e, em seguida, selecione Conectar no bloco Azure SQL MI DB (CDC).

    Captura de tela que mostra a seleção do CDC da Instância Gerenciada SQL do Azure como o tipo de fonte na página Fontes de dados.

    Use as instruções da secção Adicionar CDC de Instância Gerida do SQL do Azure como origem.

Página de fontes da Microsoft

  1. No hub em tempo real, selecione Fontes da Microsoft no menu de navegação esquerdo.

  2. Na lista suspensa Origem, selecione Azure SQL MI DB (CDC).

  3. Para Assinatura, selecione uma assinatura do Azure que tenha o grupo de recursos com seu banco de dados de Instância Gerenciada SQL do Azure.

  4. Em Grupo de recursos, selecione um grupo de recursos que tenha o banco de dados.

  5. Em Região, selecione um local onde o banco de dados está localizado.

  6. Agora, mova o rato sobre o nome da fonte CDC da base de dados da Instância Gerida do SQL do Azure que pretende conectar ao hub em Tempo Real na lista de bases de dados e selecione o botão Conectar, ou selecione ... (reticências), e, em seguida, selecione o botão Conectar.

    Captura de tela que mostra a página Códigos-fonte da Microsoft.

    Para configurar informações de conexão, use as etapas da seção Adicionar Instância Gerenciada SQL do Azure CDC como origem.

Adicionar CDC de Instância Gerenciada SQL do Azure como origem

  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: insira o endpoint a partir do portal do Azure, substituindo a vírgula entre o host e a porta por um dois-pontos. Por exemplo, se o seu Endpoint for xxxxx.public.xxxxxx.database.windows.net,3342, então deverá introduzir xxxxx.public.xxxxxx.database.windows.net:3342 no campo Servidor.

      Captura de ecrã que mostra a página de Rede com informações de Endpoint.

    • Banco de dados: insira o nome do banco de dados ao qual você deseja se conectar em sua Instância Gerenciada SQL do Azure.

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

  3. Desça e, na secção Credenciais de Conexão, siga estes passos.

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

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

  5. Agora, na página Connect, selecione Todas as tabelas ou Insira 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. Até 100 tabelas podem ser inseridas, com cada nome de tabela (incluindo o nome do esquema) limitado a 128 caracteres se usar identificadores de tabela completos diretamente.

  6. Selecione Seguinte.

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

  7. Na página Rever + Conectar, reveja o resumo e, em seguida, selecione Conectar.

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

Ver detalhes do fluxo de dados

  1. Na página Rever + Conectar, se selecionar Abrir fluxo de eventos, o assistente abre o fluxo de eventos que criou para si com o Azure SQL MI DB CDC selecionado como origem. Para fechar o assistente, selecione Fechar ou X* no canto superior direito da página.
  2. Você deve ver o fluxo nas páginas Todos os fluxos de dados e Meus fluxos de dados. Para obter etapas detalhadas, consulte Exibir detalhes de fluxos de dados no hub Fabric Real-Time.

Para saber mais sobre como consumir fluxos de dados, consulte os seguintes artigos: