Konfigurowanie połączenia obiektów usługi Salesforce

W tym artykule opisano kroki tworzenia połączenia obiektów usługi Salesforce.

Podsumowanie

Konektor obiektów Salesforce obsługuje następujące typy uwierzytelniania odpowiednio dla kopiowania i przepływu danych Gen2.

Konfigurowanie połączenia dla usługi Dataflow Gen2

Możesz połączyć dataflow Gen2 w Fabric z obiektami Salesforce, korzystając z konektorów Power Query. Wykonaj następujące kroki, aby utworzyć połączenie:

1. Sprawdź możliwości, ograniczenia i aspekty, aby upewnić się, że Państwa scenariusz jest obsługiwany.
2. Spełnij wymagania wstępne dotyczące obiektów usługi Salesforce.
3. Pobieranie danych w systemie Fabric.
4. Nawiązywanie połączenia z obiektami usługi Salesforce.

Wymagania wstępne

Aby korzystać z łącznika Salesforce Objects, musisz mieć nazwę użytkownika i hasło konta usługi Salesforce.

Ponadto należy włączyć dostęp do interfejsu API usługi Salesforce. Aby zweryfikować ustawienia dostępu, przejdź do swojej osobistej strony Salesforce, otwórz ustawienia profilu, a następnie wyszukaj i upewnij się, że pole wyboru Interfejs API włączony jest zaznaczone. Pamiętaj, że konta wersji próbnej usługi Salesforce nie mają dostępu do interfejsu API.

Obsługiwane funkcje

• Produkcja
• Dostosowany
  • Domeny niestandardowe
  • Przekierowania rekordów CNAME
  • Kolumny relacji

Ustawienia połączenia

Pobierz dane

Aby uzyskać dane w usłudze Data Factory:

1. Po lewej stronie Data Factory wybierz Obszary robocze .

2. W obszarze roboczym Data Factory wybierz pozycję Nowy>, a następnie wybierz element usługi Data Factory: przepływ danych, potok, zadanie kopiowania lub zadanie tworzenia kopii lustrzanej.

   

3. W Power Query wybierz Pobierz dane na wstążce lub wybierz Pobierz dane z innego źródła w bieżącym widoku.

   

4. Na stronie Wybieranie źródła danych użyj pozycji Wyszukaj , aby wyszukać nazwę łącznika, lub wybierz pozycję Wyświetl więcej z prawej strony listy łączników, aby wyświetlić wszystkie łączniki dostępne w usłudze Data Factory.

   

5. Jeśli zdecydujesz się wyświetlić więcej łączników, nadal możesz użyć funkcji Wyszukaj , aby wyszukać nazwę łącznika lub wybrać kategorię, aby wyświetlić listę łączników skojarzonych z tą kategorią.

   

Instrukcje dotyczące połączenia

Aby nawiązać połączenie z danymi obiektów usługi Salesforce:

1. Wybierz Obiekty Salesforce z listy łączników danych specyficznych dla produktu, a następnie wybierz Połącz. Aby uzyskać więcej informacji, zobacz Gdzie uzyskać dane.

2. W obszarze Obiekty usługi Salesforce wybierz adres URL, którego chcesz użyć do nawiązania połączenia. Wybierz adres URL produkcji, jeśli korzystasz z adresu URL produkcyjnego Salesforce (https://www.salesforce.com) do logowania.

   

   Uwaga / Notatka

   Obecnie może być konieczne wybranie niestandardowego adresu URL, wprowadzenie https://www.salesforce.com w polu tekstowym, a następnie wybranie pozycji Produkcja w celu nawiązania połączenia z danymi.

   Możesz również wybrać pozycję Niestandardowy i wprowadzić niestandardowy adres URL, aby się zalogować. Ten niestandardowy adres URL może być domeną niestandardową utworzoną w usłudze Salesforce, taką jak https://contoso.salesforce.com. Możesz również użyć niestandardowego wyboru adresu URL, jeśli używasz własnego rekordu CNAME, który przekierowuje do usługi Salesforce.

   Ponadto możesz wybrać pozycję Uwzględnij kolumny relacji. Ten wybór zmienia zapytanie poprzez uwzględnienie kolumn, które mogą być związane kluczem obcego z innymi tabelami. Jeśli to pole jest niezaznaczone, nie widzisz tych kolumn.

3. Jeśli po raz pierwszy tworzysz to połączenie, w razie potrzeby wybierz lokalną bramę danych.

4. Wybierz pozycję Zaloguj się , aby zalogować się do konta usługi Salesforce. Po pomyślnym zalogowaniu wybierz pozycję Dalej.

5. W oknie dialogowym Nawigator wybierz obiekty usługi Salesforce, które chcesz załadować. Następnie wybierz pozycję Przekształć dane , aby przekształcić dane.

Ograniczenia i zagadnienia

• Jeśli w wynikach łącznika Obiektów usługi Salesforce brakuje tabel, jedną z przyczyn może być to, że parametr ApiVersion musi zostać określony lub zaktualizowany do wersji obsługiwanej przez usługę Salesforce. Aby określić lub zaktualizować ApiVersion, użyj Edytora Zaawansowanego i jawnie dodaj ApiVersion jako parametr. Przykład:

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

  Salesforce okresowo wycofuje wersje API, dlatego upewnij się, że określasz wspieraną wersję API przez Salesforce.

• Istnieje limit liczby pól, które może zawierać zapytanie do usługi Salesforce. Limit różni się w zależności od typu kolumn, liczby obliczonych kolumn itd. Gdy wystąpi Query is either selecting too many fields or the filter conditions are too complicated błąd, oznacza to, że zapytanie przekracza limit. Aby uniknąć tego błędu, użyj opcji Zaawansowane wybieranie zapytania i określ pola, których naprawdę potrzebujesz.

• Ustawienia sesji usługi Salesforce mogą blokować tę integrację. Upewnij się, że ustawienie Zablokuj sesje na adres IP, z którego pochodzą , jest wyłączone.

• Należy włączyć dostęp do interfejsu API usługi Salesforce. Aby zweryfikować ustawienia dostępu, przejdź do ustawień profilu bieżącego użytkownika i odnaleźć pole wyboru Interfejs API włączony.

• Konta wersji próbnej usługi Salesforce nie mają dostępu do interfejsu API.

• Operacje "Utwórz rekord" i "Aktualizuj rekord" nie obsługują pól niestandardowych typu Picklist (Multi-Select).

• Adresy URL Lightning nie są obsługiwane.

• Niestandardowe adresy URL obsługują tylko domeny salesforce.com i cloudforce.com. Użycie innych domen powoduje błąd "Nieprawidłowe argumenty".

• Łącznik obiektów Salesforce nie obsługuje uwierzytelniania, gdy włączone jest rozszerzenie Proof Key for Code Exchange (PKCE).

• Usługa Salesforce ogranicza liczbę współbieżnych zapytań, które może wykonywać pojedyncze konto. Błąd "INVALID_QUERY_LOCATOR" Jest to limit usługi Salesforce i może wystąpić, gdy istnieje wiele współbieżnych zapytań względem usługi Salesforce przy użyciu tego samego konta. Ten limit obejmuje wszystkie aplikacje klienckie (nie tylko konektor PowerQuery) korzystające z interfejsu API Salesforce. Aby zmniejszyć prawdopodobieństwo wystąpienia tego błędu:

  • Upewnij się, że liczba zapytań usługi Salesforce jest zachowana do minimum.
  • Użyj dostępnych opcji (takich jak przepływy danych), aby etapować dane z usługi Salesforce.
  • Upewnij się, że inne zastosowania interfejsu API usługi Salesforce z tym samym kontem nie są zaplanowane współbieżnie.

Aby uzyskać więcej informacji na temat wewnętrznych limitów interfejsu API usługi Salesforce, zobacz Salesforce Developer Limits and Allocations Quick Reference (Limity deweloperów i alokacje usługi Salesforce — krótkie informacje).

Treści powiązane

• Aby uzyskać więcej informacji na temat tego łącznika, zobacz dokumentację łącznika obiektów usługi Salesforce.