Configurar sua conexão de objetos do Salesforce

Este artigo descreve as etapas para criar uma conexão de objetos do Salesforce.

Tipos de autenticação com suporte

O conector de objetos do Salesforce dá suporte para os seguintes tipos de autenticação para cópia e Fluxo de Dados Gen2, respectivamente.

Tipo de autenticação Copiar Fluxo de dados Gen2
Conta organizacional √ √

Configurar sua conexão para o Dataflow Gen2

Você pode conectar o Dataflow Gen2 no Microsoft Fabric a objetos Salesforce usando conectores do Power Query. Siga estas etapas para criar sua conexão:

  1. Verifique as funcionalidades, as limitações e as considerações para garantir que o cenário seja compatível.
  2. Conclua os pré-requisitos para objetos Salesforce.
  3. Obter dados no Fabric.
  4. Conecte-se aos objetos Salesforce.

Capabilities

  • Produção
  • Personalizado
    • Domínios personalizados
    • Redirecionamentos de registro CNAME
    • Colunas de relação

Pré-requisitos

Para usar o conector de Objetos do Salesforce, você deve ter o nome de usuário e a senha da conta do Salesforce.

Além disso, o acesso à API do Salesforce deve ser habilitado. Para verificar as configurações de acesso, acesse sua página pessoal do Salesforce, abra as configurações de perfil e pesquise e verifique se a caixa de seleção habilitada para API está selecionada. Observe que as contas de avaliação do Salesforce não têm acesso à API.

Obter dados

Para obter dados no Data Factory:

  1. No lado esquerdo do Data Factory, selecione Workspaces.

  2. No workspace do Data Factory, selecione Novo Fluxo de Dados Gen2> para criar um novo fluxo de dados.

    Captura de tela mostrando o workspace em que você escolhe criar um novo fluxo de dados.

  3. No Power Query, selecione Obter dados na faixa de opções ou selecione Obter dados de outra origem na exibição atual.

    Captura de tela mostrando o workspace do Power Query com a opção Obter dados enfatizada.

  4. Na página Escolher fonte de dados, use Pesquisar para pesquisar o nome do conector ou selecione Exibir mais à direita do conector para ver uma lista de todos os conectores disponíveis no serviço do Power BI.

    Captura de tela da página Escolher fonte de dados do Data Factory com a caixa de pesquisa e o modo de exibição mais seleção enfatizado.

  5. Se você optar por exibir mais conectores, ainda poderá usar Pesquisar para pesquisar o nome do conector ou escolher uma categoria para ver uma lista de conectores associados a essa categoria.

    Captura de tela da página Escolher fonte de dados do Data Factory exibida após selecionar ver mais, com a lista de conectores.

Conectar a objetos do Salesforce

Para se conectar aos dados do Salesforce Objects:

  1. Selecione Objetos Salesforce na lista de conectores de dados específicos do produto e, em seguida, Conectar. Para obter mais informações, acesse Onde obter dados.

  2. Em objetos Salesforce, escolha a URL que você deseja usar para se conectar. Selecione a URL de Produção se você usar a URL de produção do Salesforce (https://www.salesforce.com) para entrar.

    Captura de tela da janela Conectar na fonte de dados em que você adiciona informações de conexão dos Objetos Salesforce.

    Observação

    No momento, talvez seja necessário selecionar a URL Personalizada , inserir https://www.salesforce.com na caixa de texto e, em seguida, selecionar Produção para se conectar aos seus dados.

    Você também pode selecionar Personalizado e inserir uma URL personalizada para entrar. Essa URL personalizada pode ser um domínio personalizado que você criou no Salesforce, como https://contoso.salesforce.com. Você também pode usar a seleção de URL personalizada se estiver usando seu próprio registro CNAME que redireciona para o Salesforce.

    Além disso, você pode selecionar Incluir colunas de relação. Essa seleção altera a consulta incluindo colunas que podem ter relações de chave estrangeira com outras tabelas. Se essa caixa estiver desmarcada, você não verá essas colunas.

  3. Se você estiver fazendo essa conexão pela primeira vez, selecione um gateway de dados local, se necessário.

  4. Selecione Entrar para entrar em sua conta do Salesforce. Depois de entrar com êxito, selecione Avançar.

  5. Na caixa de diálogo Navegador , selecione os Objetos salesforce que você deseja carregar. Em seguida, selecione Transformar Dados para transformar os dados.

Limitações e considerações

  • Se houver tabelas ausentes nos resultados do conector de Objetos Salesforce, uma das causas pode ser a necessidade de especificar ou atualizar a ApiVersion para uma versão que o Salesforce suporte. Para especificar ou atualizar o ApiVersion, use o Editor Avançado e adicione explicitamente o ApiVersion parâmetro. Por exemplo:

    Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

    O Salesforce abandona periodicamente versões da API, portanto, verifique se você está especificando uma versão da API com suporte do Salesforce.

  • Há um limite no número de campos que uma consulta para o Salesforce pode conter. O limite varia dependendo do tipo das colunas, do número de colunas computadas e assim por diante. Quando você recebe o Query is either selecting too many fields or the filter conditions are too complicated erro, isso significa que sua consulta excede o limite. Para evitar esse erro, use a opção avançada Selecionar Consulta e especifique os campos de que você realmente precisa.

  • As configurações de sessão do Salesforce podem bloquear essa integração. Certifique-se de que a configuração Bloquear sessões para o endereço IP de origem esteja desabilitada.

  • O acesso à API do Salesforce deve ser habilitado. Para verificar as configurações de acesso, acesse as configurações de perfil do usuário atual e procure pela caixa de seleção API Ativado.

  • As contas de avaliação do Salesforce não têm acesso à API.

  • As operações "Criar registro" e "Atualizar registro" não dão suporte a campos personalizados do tipo Picklist (Multi-Select).

  • Não há suporte para URLs Lightning.

  • As URLs personalizadas só dão suporte aos domínios salesforce.com e cloudforce.com. O uso de outros domínios resulta em um erro "Argumentos Inválidos".

  • O Salesforce limita o número de consultas simultâneas que uma única conta pode executar. Erro 'INVALID_QUERY_LOCATOR' Esse é um limite do Salesforce e pode ser encontrado quando há várias consultas simultâneas no Salesforce usando a mesma conta. Esse limite inclui todos os aplicativos cliente (não apenas o conector do PowerQuery) usando a API do Salesforce. Para reduzir a probabilidade deste erro:

    • Verifique se o número de consultas do Salesforce é mantido no mínimo.
    • Use as opções disponíveis (como fluxos de dados) para organizar os dados do Salesforce.
    • Confirme se outros usos da API do Salesforce com a mesma conta não estão agendados simultaneamente.

Para obter mais informações sobre os limites da API interna do Salesforce, acesse a Referência Rápida de Limites e Alocações de Desenvolvedores do Salesforce.

Conteúdo relacionado

  • Last updated on