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 suportados

O conector de objetos do Salesforce oferece suporte aos seguintes tipos de autenticação para cópia e Dataflow Gen2, respectivamente.

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

Configurar sua conexão para Dataflow Gen2

Pode ligar Dataflow Gen2 no Microsoft Fabric a objetos Salesforce usando conectores Power Query. Siga estes passos para criar a sua ligação:

  1. Verifique capacidades, limitações e considerações para garantir que o seu cenário é suportado.
  2. Completar os pré-requisitos para os objetos Salesforce.
  3. Obtenha dados no Fabric.
  4. Ligue-se aos Objetos Salesforce.

Capabilities

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

Pré-requisitos

Para usar o conector do Salesforce Objects, você deve ter um nome de usuário e uma 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 do perfil e pesquise e verifique se a caixa de seleção API ativada está marcada . 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 espaço de trabalho do Data Factory, selecione Novo>Dataflow Gen2 para criar um novo fluxo de dados.

    Captura de tela mostrando o espaço de trabalho onde você escolhe criar um novo fluxo de dados.

  3. No Power Query, selecione Obter dados no friso ou selecione Obter dados de outra origem na vista atual.

    Captura de ecrã a mostrar a área de trabalho do Power Query com a opção Obter dados realçada.

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

    Captura da página Data Factory Escolher fonte de dados com a caixa de pesquisa e a opção Ver mais enfatizada.

  5. Se optares por visualizar mais conectores, podes ainda usar a Pesquisa para encontrar o nome do conector ou escolher uma categoria para ver uma lista de conectores associados a essa categoria.

    Captura de ecrã da página

Liga-te aos Objetos Salesforce

Para conectar-se aos dados do Salesforce Objects:

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

  2. Em objetos do 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 fazer login.

    Captura de tela da janela Conectar à fonte de dados onde você adiciona informações de conexão do Salesforce Objects.

    Observação

    Atualmente, 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.

    Também pode selecionar Personalizar e introduzir um URL personalizado para iniciar sessão. Essa URL personalizada pode ser um domínio personalizado criado 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 relacionamento. 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 fazer login na sua conta do Salesforce. Depois de iniciar sessão com êxito, selecione Seguinte.

  5. Na caixa de diálogo Navegador , selecione os objetos do Salesforce que deseja carregar. Em seguida, selecione Transformar dados para transformar os dados.

Limitações e considerações

  • Se houver tabelas ausentes nos resultados do conector Salesforce Objects, uma causa pode ser que o ApiVersion deva ser especificado ou atualizado para uma versão suportada pelo Salesforce. 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])

    A Salesforce descontinua periodicamente as versões de API, por isso, certifique-se de especificar uma versão de API suportada pelo Salesforce.

  • Há um limite para o número de campos que uma consulta ao Salesforce pode conter. O limite varia dependendo do tipo de 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 Selecionar consulta avançada e especifique os campos 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 do qual elas se originaram está desativada .

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

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

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

  • Os URL de Lightning não são suportados.

  • URLs personalizadas apenas suportam os domínios salesforce.com e cloudforce.com. A utilização de outros domínios resulta num erro de "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) que usam a API do Salesforce. Para reduzir a probabilidade deste erro:

    • Certifique-se de que o número de consultas do Salesforce seja mantido a um mínimo.
    • Utilize as opções disponíveis (como fluxos de dados) para armazenar temporariamente os dados provenientes 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 internos da API do Salesforce, vá para Referência rápida de limites e alocações do desenvolvedor do Salesforce.

Conteúdo relacionado

  • Last updated on