Configurar o Dataverse em uma atividade de cópia

Este artigo oferece uma descrição de como usar a atividade de cópia em um pipeline para copiar dados de e para o Dataverse.

Pré-requisitos

Para usar esse conector com a autenticação de principal da 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 (Entidade de Serviço) no Microsoft Entra. Para obter mais informações, consulte Criar um aplicativo Microsoft Entra e um principal de serviço que possa 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 que recebeu permissões no Dataverse. Para obter mais informações sobre como configurar um usuário de aplicativo para autenticar com o Dataverse, consulte Usar autenticação de locatário único de servidor a servidor.

Configuração com suporte

Para a configuração de cada guia em atividade Copy, vá para as seções a seguir, respectivamente.

• Geral
• Fonte
• Destino
• Mapeamento
• Settings

Geral

Para a configuração da guia Geral, vá para as configurações gerais.

Source

Vá para a guia Origem para configurar a origem 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 do Dataverse selecionando Novo.
• Tipo de conexão: Selecione o Dataverse.
• Use a consulta: especifique a maneira usada para ler dados. Você pode optar por nome da entidade para ler dados usando o nome da entidade ou consulta para usar uma 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 usada no Dynamics online e no local. Veja o exemplo a seguir. Para saber mais, consulte Criar consultas com FetchXML.

    Consulta FetchXML de exemplo:

    <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 tem suporte para o último. Para obter mais informações, acesse Adicionar colunas adicionais durante a cópia.

Destino

Vá para a aba 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 do Dataverse selecionando Novo.
• Tipo de conexão: Selecione o 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. Esse é 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. Essa propriedade é necessá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 definido na sua entidade para inserir ou atualizar registros.
• Ignorar valores nulos: indica se os valores nulos devem ser ignorados dos dados de entrada durante a operação de gravação. Ele é selecionado por padrão.
  • Quando estiver 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 de inserção.
  • Quando ele não for selecionado: 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 de inserção.
• 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 estabelecidas para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando desejar limitar as conexões simultâneas.

Mapeamento

Para a configuração da guia Mapeamento, vá para Configurar seus mapeamentos na guia mapeamento. Se você escolher Binário como seu formato de arquivo, não haverá suporte para mapeamento.

Configurações

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

Sumário da tabela

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

Informações de origem

Informações de destino

Conteúdo relacionado

• Visão geral do conector do Dataverse