Configurar Dataverse numa atividade de cópia

Este artigo descreve como usar a atividade de cópia num pipeline para transferir dados de e para o Dataverse.

Pré-requisitos

Para usar esse conector com a autenticação de entidade de serviço do Microsoft Entra, você deve configurar a autenticação de servidor para servidor (S2S) no Dataverse. Primeiro, registre o usuário do aplicativo (Service Principal) no Microsoft Entra. Para obter mais informações, consulte Criar um aplicativo e uma entidade de serviço do Microsoft Entra que possam acessar recursos.

Durante o registro do aplicativo, você precisará criar esse usuário no Dataverse e conceder permissões. Essas permissões podem ser concedidas direta ou indiretamente, adicionando o usuário do aplicativo a uma equipe à qual foram concedidas permissões no Dataverse. Para obter mais informações sobre como configurar um utilizador de aplicações para autenticar-se com o Dataverse, consulte Utilizar autenticação de servidor para servidor de inquilino único.

Configuração suportada

Para configurar cada separador na atividade de cópia, vá respetivamente para as secções seguintes.

• General
• Source
• Destination
• Mapeamento
• Settings

General

Para Configuração da guia Geral , vá para Configurações gerais.

Fonte

Vá para o separador Source para configurar a sua fonte de atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

As seguintes propriedades são necessárias:

• Conexão: Selecione uma conexão Dataverse existente na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão Dataverse selecionando Novo.
• Tipo de conexão: Selecione Dataverse.
• Usar consulta: especifique a maneira usada para ler dados. Você pode escolher Nome da entidade para ler dados usando o nome da entidade ou Consulta para usar a consulta para ler dados.

  • Nome da entidade: selecione o nome da entidade na lista suspensa ou selecione Editar para inseri-lo manualmente. É o nome lógico da entidade a ser recuperada.

  • Consulta: Usando FetchXML para ler dados do Dataverse. FetchXML é uma linguagem de consulta proprietária que é usada no Dynamics online e local. Veja o seguinte exemplo. Para saber mais, consulte Criar consultas com FetchXML.

    Exemplo de consulta FetchXML:

    <fetch>
      <entity name="account">
        <attribute name="accountid" />
        <attribute name="name" />
        <attribute name="marketingonly" />
        <attribute name="modifiedon" />
        <order attribute="modifiedon" descending="false" />
        <filter type="and">
          <condition attribute ="modifiedon" operator="between">
            <value>2017-03-10 18:40:00z</value>
            <value>2017-03-12 20:40:00z</value>
          </condition>
        </filter>
      </entity>
    </fetch>
    

Em Avançado, você pode especificar os seguintes campos:

• Colunas adicionais: Adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão é suportada para a segunda opção. Para obter mais informações, vá para Adicionar colunas adicionais durante a cópia.

Destino

Vá para o separador de Destino para configurar o destino da atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

As seguintes propriedades são necessárias:

• Conexão: Selecione uma conexão Dataverse existente na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão Dataverse selecionando Novo.
• Tipo de conexão: Selecione Dataverse.
• Nome da entidade: especifique o nome da entidade para gravar dados. Selecione o nome da entidade na lista suspensa ou selecione Editar para inseri-lo manualmente. Este é o nome lógico da entidade a ser recuperada.

Em Avançado, você pode especificar os seguintes campos:

• Comportamento de gravação: O comportamento de gravação da operação. Esta propriedade é obrigatória e você deve selecionar Upsert. Se você usar Adicionar conteúdo dinâmico, especifique o valor para Upsert.
• Nome da chave alternativa: especifique o nome da chave alternativa definida em sua entidade para atualizar os registros.
• Ignorar valores nulos: Indica se os valores nulos dos dados de entrada devem ser ignorados durante a operação de gravação. Ele é selecionado por padrão.
  • Quando for selecionado: Deixe os dados no objeto de destino inalterados ao fazer a operação upsert/update e insira o valor padrão definido ao fazer a operação insert.
  • Quando estiver desmarcado: atualize os dados no objeto de destino para NULL ao fazer a operação upsert/update e insira o valor NULL ao fazer a operação insert.
• Tamanho do lote de gravação: especifique a contagem de linhas de dados gravados no Dataverse em cada lote.
• Máximo de conexões simultâneas: o limite superior de conexões simultâneas estabelecido para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas.

Mapeamento

Para Configuração da guia Mapeamento , vá para Configurar seus mapeamentos na guia Mapeamento. Se você escolher binário como seu formato de arquivo, o mapeamento não será suportado.

Configurações

Para a configuração da guia Configurações , vá para Configurar suas outras configurações na guia configurações.

Resumo da tabela

Consulte a tabela a seguir para obter o resumo e mais informações sobre a atividade de cópia do Dataverso.

Fonte da informação

Informações sobre o destino

Conteúdo relacionado

• Visão geral do conector Dataverse