Configurar Dataverse em uma atividade de cópia

Este artigo descreve como usar a atividade de cópia em um pipeline de dados para copiar 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 usuário de aplicativo para autenticar com o Dataverse, consulte Usar autenticação de servidor para servidor de locatário único.

Configuração suportada

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

• General (Geral)
• Source
• Destino
• Mapeamento
• Administração

Geral

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

Source

Vá para a guia Origem para configurar 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:

• Tipo de armazenamento de dados: Selecione Externo.
• 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 este último. Para obter mais informações, vá para Adicionar colunas adicionais durante a cópia.

Destino

Vá para a guia 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:

• Tipo de armazenamento de dados: Selecione Externo.
• 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.

Definiçõ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údos relacionados

• Visão geral do conector Dataverse