Configurar o 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ê precisará de 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 do Microsoft Entra e uma entidade 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 servidor para servidor de locatário único.

Configuração com suporte

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

• Geral
• Origem
• Destino
• Mapeamento
• Configurações

Geral

Para a configuração da guia Geral, acesse Configurações gerais.

Fonte

Acesse 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:

• Tipo de armazenamento de dados: selecione Externo.
• Conexão: selecione uma conexão existente do Dataverse na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do 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 ler dados usando a consulta.

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

Destino

Acesse 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 existente do Dataverse na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do 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. 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 da operação de gravação. Essa propriedade é necessária e você deve selecionar Upsert. Se você usar Adicionar conteúdo dinâmico, especifique o valor como Upsert.
• Nome alternativo da chave: especifique o nome de chave alternativo definido em sua entidade para registros do Upsert.
• Ignorar valores nulos: indica se deve ignorar valores nulos de dados de entrada durante a operação de gravação. Ele é selecionado por padrão.
  • Quando está selecionado: deixe os dados no objeto de destino inalterados ao fazer a operação upsert/atualização e insira valor definido pelo padrão ao fazer a operação de inserção.
  • Quando não está selecionado: atualize os dados no objeto de destino inalterados para NULL ao fazer a operação upsert/atualização e insira valor definido pelo padrão 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 configuração da guia Mapeamento, vá para Configurar seus mapeamentos na guia mapeamento. Se você escolher Binário como formato de arquivo, não haverá suporte para mapeamento.

Configurações

Para configuração da guia Configurações, acesse Definir 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 Dataverse.

Informações de origem

Nome	Descrição	Valor	Obrigatório	Propriedade de script JSON
Tipo de armazenamento de dados	Seu tipo de armazenamento de dados.	Externo	Yes	/
Conexão	Sua conexão com o Dataverse de origem.	< sua conexão >	Yes	connection
Tipo de conexão	Seu tipo de conexão.	Dataverse	Sim	tipo(em typeProperties ->source ->datasetSettings): CommonDataServiceForAppsEntity
Usar a consulta	A maneira de ler dados do Dataverse	*Tabelas *Consulta	Sim	/
Nome da entidade	O nome lógico da entidade a ser recuperada.	< seu nome de entidade >	Sim	entityName
Consulta	Use FetchXML para ler dados do Dataverse. FetchXML é uma linguagem de consulta proprietária usada no Dynamics online e local. Para obter mais informações, confira Criar consultas com FetchXML.	< sua consulta >	Sim	Consulta
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.	* Nome * Valor	Não	additionalColumns: * nome * valor

Informações de destino

Nome	Descrição	Valor	Obrigatório	Propriedade de script JSON
Tipo de armazenamento de dados	Seu tipo de armazenamento de dados.	Externo	Yes	/
Conexão	Sua conexão com o Dataverse de destino.	< sua conexão >	Yes	connection
Tipo de conexão	Seu tipo de conexão.	Dataverse	Sim	tipo(em typeProperties ->sink ->datasetSettings): CommonDataServiceForAppsEntity
Nome da entidade	O nome lógico da entidade a ser recuperada.	< sua entidade >	Sim	entityName
Comportamento de gravação	O comportamento da operação de gravação. O valor precisa ser Upsert.	Upsert	Sim	writeBehavior: upsert
nome alternativo da chave	O nome da chave alternativa definido na entidade para registros upsert.	< nome da chave alternativa >	Não	alternateKeyName
Ignorar valores nulos	Indica se deve ignorar valores nulos de dados de entrada durante a operação de gravação. - Selecionado (true): deixe os dados no objeto de destino inalterados ao fazer a operação upsert/atualização e insira valor definido pelo padrão ao fazer a operação de inserção. - Não selecionado (false): atualize os dados no objeto de destino inalterados para NULL ao fazer a operação upsert/atualização e insira valor definido pelo padrão ao fazer a operação de inserção.	selecionado ou não selecionado (padrão)	Não	ignoreNullValues: true ou false (padrão)
Tamanho do lote de gravação	A contagem de linhas de dados gravados no Dataverse em cada lote.	<seu tamanho do lote de gravação> O valor padrão é 10	Não	writeBatchSize
Máximo de conexões simultâneas	O limite superior de conexões simultâneas estabelecidas com o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando desejar limitar as conexões simultâneas.	< máximo de conexões simultâneas >	Não	maxConcurrentConnections

Conteúdo relacionado

• Visão geral do conector do Dataverse