Federacja katalogu Workday Data Connect

Ważna

Ta funkcja jest dostępna w wersji beta. Aby z niego korzystać, administrator przestrzeni roboczej musi włączyć Workday Data Connect Connector na stronie Podglądów . Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.

Użyj federacji katalogu Workday Data Connect, aby czytać tabele Workday Data Connect bezpośrednio z pamięci w chmurze i dodawać je do Unity Catalog jako tabele zagraniczne. Zapytania działają całkowicie na obliczeniach Azure Databricks, dzięki czemu zespoły danych mogą odkrywać, zarządzać i zapytywać te tabele z Azure Databricks bez konieczności budowania potoków ETL. Dostęp do danych jest tylko do odczytu.

Azure Databricks uwierzytelnia się do katalogu Workday Data Connect jako użytkownik systemu integracyjnego Workday (ISU), którego rejestrujesz jako podmiot, używając OAuth z kluczem prywatnym.

Workday nazywa ten produkt Workday Data Lake. Dokumentacja partnerów, w tym ta strona, nazywa ją Workday Data Connect.

Aby dowiedzieć się więcej o federacji katalogowej, zobacz: Co to jest federacja katalogów?.

Note

Ten łącznik nie pobiera ani nie kopiuje danych do Azure Databricks i nie jest powiązany z konektorami Lakeflow Connect dla Workday. Aby zamiast tego pozyskiwać dane Workday do usługi Azure Databricks, zobacz konektor Workday Reports lub konektor Workday HCM.

Requirements

Przed utworzeniem federacji katalogowej Workday Data Connect zapoznaj się z poniższymi wymaganiami.

Wymagania dotyczące obszaru roboczego:

• Obszar roboczy musi mieć włączony Unity Catalog. Zobacz Rozpocznij pracę z Unity Catalog.

Wymagania dotyczące obliczeń:

• Obliczenia Azure Databricks muszą korzystać z Databricks Runtime 19.8 lub wyższego oraz standardowego trybu dostępu. Tryb dedykowanego dostępu nie jest obsługiwany.

Wymagania dotyczące sieci:

• Łączność sieciowa z usługi Azure Databricks do punktu końcowego katalogu Workday Data Connect pod adresem https://<workday-host>/api/catalog. Nie musisz dodawać adresów IP usługi Azure Databricks do listy dozwolonych w Workday.

Wymagane uprawnienia:

• Aby utworzyć połączenie, musisz być administratorem magazynu metadanych lub użytkownikiem z uprawnieniami CREATE CONNECTION w magazynie metadanych Unity Catalog dołączonym do obszaru roboczego.
• Aby utworzyć katalog zagraniczny, musisz mieć uprawnienie CREATE CATALOG w metastore i być właścicielem połączenia lub mieć uprawnienia CREATE FOREIGN CATALOG dla połączenia.

Wymagania dotyczące dnia pracy:

• Workday Data Connect jest włączony dla Twojego tenanta Workday, a tabele, które chcesz zapytać, są udostępniane przez katalog Iceberg REST. Zobacz Jak zacząć z Workday Data Lake.
• Użytkownik systemu integracji Workday (ISU) zarejestrowany jako podmiot w katalogu Workday Data Connect, główna rola dla tego ISU, która udziela dostępu do odczytu do współdzielonych tabel, oraz para kluczy RSA dla tego podmiotu. Aby zarejestrować klienta API, zobacz Register API Client for Data Lake (JWT Bearer Grant).

Krok 1: Stwórz połączenie

Połączenie określa punkt końcowy i dane uwierzytelniające, których Azure Databricks używa do komunikacji z katalogiem Workday Data Connect.

Aby utworzyć połączenie, użyj Eksploratora Katalogu lub CREATE CONNECTION polecenia SQL:

Eksplorator wykazu

Aby utworzyć połączenie:

1. W obszarze roboczym Azure Databricks kliknij pozycję Catalog.
2. W górnej części okienka Wykaz kliknij i wybierz pozycję Utwórz połączenie z menu.
3. Na stronie podstaw połączenia wpisz nazwę połączenia.
4. Wybierz typ połączeniaWorkday Data Connect.
5. Kliknij Dalej.
6. Na stronie szczegółów połączenia wpisz następujące wartości:
   • Host: Na przykład mycompany.myworkday.comnazwa hosta Twojego endpointu Workday Data Connect .
   • Najemca: Twój najemca Workday.
   • ID klienta: ID klienta klienta API Workday.
   • Klucz prywatny: Klucz prywatny RSA w formacie PEM.
   • Nazwa główna: Nazwa ISU, którą zarejestrowałeś jako dyrektor katalogowy.
   • Rola nadrzędna: Rola nadrzędna w Workday, która określa zakres dostępu do odczytu dla tabel współdzielonych. Wartość domyślna to ALL. Aby ograniczyć zakres dostępu, ustaw konkretną rolę, na przykład all-reads-role.

SQL

Uruchom następujące polecenie w notesie lub edytorze zapytań SQL usługi Databricks:

CREATE CONNECTION <connection-name> TYPE WORKDAY_DATA_CONNECT
OPTIONS (
  host '<workday-host>',
  tenant '<workday-tenant>',
  client_id '<client-id>',
  private_key secret('<secret-scope>','<secret-key>'),
  principal_name '<isu-name>',
  principal_role '<principal-role>'
);

• host: Nazwa hosta punktu końcowego Workday Data Connect, na przykład mycompany.myworkday.com.
• tenant: Twój najemca Workday.
• client_id: ID klienta klienta API Workday.
• private_key: Klucz prywatny RSA w formacie PEM. Databricks zaleca, aby przechowywać go jako sekret.
• principal_name: Nazwa ISU zarejestrowanego jako główny podmiot katalogu.
• principal_role: Główna rola Workday, która określa zakres dostępu do odczytu do współdzielonych tabel. Wartość domyślna to ALL. Aby ograniczyć zakres dostępu, ustaw konkretną rolę, na przykład all-reads-role.

Databricks zaleca używanie sekretów zamiast tekstu jawnego dla wrażliwych wartości, takich jak klucz prywatny. Informacje o tworzeniu sekretów można znaleźć w artykule Zarządzanie tajemnicami.

Krok 2: Stwórz katalog zagraniczny

Katalog zewnętrzny odzwierciedla katalog Workday Data Connect w Unity Catalog, dzięki czemu możesz używać Unity Catalog do zarządzania dostępem do tabel Workday i wykonywania na nich zapytań za pomocą zasobów obliczeniowych Azure Databricks.

Aby utworzyć katalog zagraniczny, możesz użyć Catalog Explorer lub CREATE FOREIGN CATALOG polecenia SQL w notatniku albo edytora zapytań SQL Databricks.

Eksplorator wykazu

1. W obszarze roboczym Azure Databricks kliknij pozycję Catalog.
2. W górnej części okienka Wykaz kliknij i wybierz pozycję Utwórz wykaz z menu.
3. W oknie dialogowym Utwórz nowy katalog wpisz nazwę katalogu.
4. Wybierz typobcy.
5. Wybierz połączenie , które stworzyłeś w kroku 1.
6. W polu Lokalizacja magazynu wprowadź ścieżkę do magazynu w chmurze, w której usługa Azure Databricks przechowuje metadane federowanych tabel.
7. Kliknij pozycję Utwórz.

SQL

Uruchom następujące polecenie w notesie lub edytorze zapytań SQL usługi Databricks. Elementy w nawiasach są opcjonalne.

CREATE FOREIGN CATALOG [IF NOT EXISTS] <catalog-name>
USING CONNECTION <connection-name>
OPTIONS (storage_root '<storage-root-path>');

• storage_root: Wymagane. Ścieżka do lokalizacji zewnętrznej, w której usługa Azure Databricks może zapisywać dane. Azure Databricks wykorzystuje tę lokalizację do przechowywania metadanych dla federowanych tabel. Dane tabeli Workday nie są kopiowane do tej lokalizacji.

Katalog zagraniczny zawsze odzwierciedla cały katalog Workday Data Connect, do którego Twoje dane logowania dają dostęp. Aby ograniczyć zakres widoczności, ustaw tak, principal_role aby uzyskać dostęp do odczytu tylko do wybranych tabel podczas tworzenia połączenia.

Krok 3: Przyznaj uprawnienia i zapytaj katalog

Po utworzeniu katalogu zagranicznego użytkownicy muszą mieć odpowiednie uprawnienia Unity Catalog, aby uzyskać dostęp do federowanych tabel:

• Wszyscy użytkownicy potrzebują odpowiednio USE CATALOG i USE SCHEMA uprawnień do katalogu i schematu.
• Aby odczytywać dane z tabeli federowanej, użytkownicy potrzebują uprawnienia SELECT.

Aby uzyskać więcej informacji na temat uprawnień katalogu Unity i sposobu ich przyznawania, zobacz Zarządzanie uprawnieniami w katalogu Unity.

Na przykład wykonaj następujące polecenia w notatniku lub edytorze zapytań SQL Databricks:

GRANT USE CATALOG ON CATALOG <catalog-name> TO `<principal>`;
GRANT USE SCHEMA ON SCHEMA <catalog-name>.<schema-name> TO `<principal>`;
GRANT SELECT ON TABLE <catalog-name>.<schema-name>.<table-name> TO `<principal>`;

Użytkownicy mający te uprawnienia mogą następnie wysyłać zapytania do tabel sfederowanych za pomocą trójpoziomowej notacji przestrzeni nazw:

SELECT * FROM <catalog-name>.<schema-name>.<table-name>;

Mapowanie przestrzeni nazw

Unity Catalog odzwierciedla hierarchię obiektów Workday Data Connect w następujący sposób:

Obiekt Workday Data Connect	Obiekt katalogu Unity
Catalog	Wykaz obcy
Namespace	Schema
Table	Tabela zagraniczna

Workday Data Connect udostępnia płaskie nazwy trzypoziomowe, które w relacji jeden do jednego odpowiadają hierarchii Unity Catalog catalog.schema.table. Nie ma dodatkowego gniazdowania w przestrzeniach nazw.

Ograniczenia

Federacja katalogu Workday Data Connect ma następujące ograniczenia:

• Konektor może uzyskać dostęp tylko do tabel Iceberg udostępnionych przez katalog Workday Data Connect.
• Nazwy schematów i tabel spełniają standardowe ograniczenia nazewnictwa Unity Catalog. Azure Databricks nie obsługuje nazw zawierających kropkę (.), spację ( ) ani ukośnik (/). Zobacz Wymagania dotyczące nazewnictwa obiektów zabezpieczanych.