Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Na tej stronie opisano sposób nawiązywania połączenia z lokalizacją zewnętrzną Cloudflare R2. Po nawiązaniu połączenia można zarządzać dostępem do tych obiektów R2 za pomocą Unity Catalog.
Aby pomyślnie połączyć się ze ścieżką Cloudflare R2, potrzebne są dwa obiekty zabezpieczalne Unity Catalog. Pierwszym z nich jest poświadczenie magazynu danych, które określa token API R2 umożliwiający dostęp do lokacji R2. Potrzebujesz tego poświadczenia magazynu danych do drugiego wymaganego obiektu: lokalizacji zewnętrznej, która definiuje ścieżkę do lokalizacji magazynu danych R2 oraz poświadczenia wymagane do uzyskania dostępu do tej lokalizacji.
Requirements
Obszar roboczy usługi Databricks jest włączony do Unity Catalog.
Databricks Runtime 14.3 lub nowszy albo Magazyn SQL 2024.15 lub nowszy.
Jeśli wystąpi komunikat o błędzie
No FileSystem for scheme "r2”, twój komputer prawdopodobnie działa na nieobsługiwanej wersji.Konto Cloudflare. Zobacz: https://dash.cloudflare.com/sign-up.
Rola administratora Cloudflare R2. Zapoznaj się z dokumentacją ról Cloudflare.
uprawnienia
CREATE STORAGE CREDENTIALiCREATE EXTERNAL LOCATIONw magazynie metadanych Unity Catalog przypisanym do obszaru roboczego. Administratorzy konta i administratorzy magazynu metadanych domyślnie mają te uprawnienia.
Krok 1. Konfigurowanie zasobnika R2
Utwórz zasobnik Cloudflare R2.
Możesz użyć pulpitu nawigacyjnego Cloudflare lub narzędzia Cloudflare Wrangler.
Zapoznaj się z dokumentacją rozwiązania Cloudflare R2 "Wprowadzenie" lub dokumentacją platformy Wrangler.
Utwórz token interfejsu API R2 i zastosuj go do zasobnika.
Zapoznaj się z dokumentacją uwierzytelniania interfejsu API Cloudflare R2.
Ustaw następujące właściwości tokenu:
Uprawnienia: Odczyt i zapis obiektu.
To uprawnienie przyznaje dostęp do odczytu i zapisu, który jest wymagany w przypadku używania magazynu R2 jako celu replikacji, zgodnie z opisem w temacie Korzystanie z replik Cloudflare R2 lub migrowanie magazynu do języka R2.
Jeśli chcesz wymusić dostęp tylko do odczytu z usługi Azure Databricks do zasobnika R2, możesz zamiast tego utworzyć token, który udziela dostępu tylko do odczytu. Może to być jednak niepotrzebne, ponieważ można oznaczyć dane magazynowe jako tylko do odczytu, a każdy dostęp do zapisu przyznany na podstawie tego uprawnienia zostanie zignorowany.
(Opcjonalnie) TTL: Długość czasu, przez który chcesz udostępniać dane w wiadrze odbiorcom danych.
(Opcjonalnie) Filtrowanie adresów IP klienta: wybierz, czy chcesz ograniczyć dostęp sieciowy do określonych adresów IP adresata. Jeśli ta opcja jest włączona, musisz określić adresy IP swoich odbiorców oraz dodać do listy dozwolonych adres NAT płaszczyzny sterowania Databricks dla regionu obszaru roboczego.
Skopiuj wartości tokenu interfejsu API R2:
- Identyfikator klucza dostępu
- Klucz dostępu tajnego
Ważna
Wartości tokenu są wyświetlane tylko raz.
Na stronie głównej R2 przejdź do pozycji Szczegóły konta i skopiuj identyfikator konta R2.
Krok 2. Tworzenie poświadczeń magazynu
W usłudze Azure Databricks zaloguj się do obszaru roboczego.
Kliknij
Wykaz.
Kliknij przycisk Dane >zewnętrzne, przejdź do karty Poświadczenia i wybierz pozycję Utwórz poświadczenia.
Wybierz Poświadczenie magazynowe.
Wybierz typ poświadczeniatokenu API Cloudflare.
Wprowadź nazwę poświadczenia i następujące wartości skopiowane podczas konfigurowania zasobnika R2:
- Identyfikator konta
- Identyfikator klucza dostępu
- Klucz dostępu sekretnego
(Opcjonalnie) Jeśli chcesz, aby użytkownicy mieli dostęp tylko do odczytu do lokalizacji zewnętrznych korzystających z tego poświadczenia magazynu, w obszarze Opcje zaawansowane wybierz pozycję Tylko do odczytu.
Nie wybieraj tej opcji, jeśli chcesz użyć poświadczeń magazynu w celu uzyskania dostępu do magazynu R2, którego używasz jako celu replikacji, zgodnie z opisem w temacie Używanie replik Cloudflare R2 lub migrowanie magazynu do wersji R2.
Aby uzyskać więcej informacji, zobacz Oznaczanie poświadczeń magazynu jako tylko do odczytu.
Kliknij pozycję Utwórz.
W oknie dialogowym Utworzone poświadczenie magazynu skopiuj zewnętrzny identyfikator.
(Opcjonalnie) Powiąż poświadczenie dostępu do magazynu danych z określonymi obszarami roboczymi.
Domyślnie poświadczenia magazynu mogą być używane przez dowolnego uprzywilejowanego użytkownika w dowolnym obszarze roboczym dołączonym do magazynu metadanych. Jeśli chcesz zezwolić na dostęp tylko z określonych obszarów roboczych, przejdź do karty Obszary robocze i przypisz obszary robocze. Zobacz Przypisywanie poświadczenia dostępu do magazynu do określonych obszarów roboczych.
Krok 3. Tworzenie lokalizacji zewnętrznej
Aby utworzyć lokalizację zewnętrzną, użyj Eksploratora katalogu, jeśli wolisz graficzny interfejs użytkownika, albo SQL, jeśli wolisz tworzenie programistyczne.
Opcja 1. Tworzenie lokalizacji zewnętrznej przy użyciu Eksploratora wykazu
Zaloguj się do obszaru roboczego dołączonego do magazynu metadanych.
Na pasku bocznym kliknij
Wykaz.
Kliknij przycisk Dane >zewnętrzne, przejdź do karty Lokalizacje zewnętrzne i kliknij pozycję Utwórz lokalizację zewnętrzną.
W oknie dialogowym Tworzenie nowej lokalizacji zewnętrznej kliknij pozycję Ręcznie, a następnie przycisk Dalej.
Nie można użyć opcji Szybkiego startu platformy AWS, aby utworzyć lokalizację zewnętrzną dla głównego systemu plików DBFS.
W oknie dialogowym Tworzenie nowej lokalizacji zewnętrznej ręcznie wprowadź nazwę lokalizacji zewnętrznej.
W obszarze Typ magazynu wybierz pozycję R2.
W obszarze Adres URL wprowadź ścieżkę. Na przykład
r2://my-bucket@my-account-id.r2.cloudflarestorage.com.W obszarze Poświadczenia magazynu wybierz poświadczenia magazynu, które udzielają dostępu do lokalizacji zewnętrznej.
(Opcjonalnie) Jeśli chcesz, aby użytkownicy mieli dostęp tylko do odczytu do lokalizacji zewnętrznej, kliknij pozycję Opcje zaawansowane i wybierz pozycję Ogranicz do użycia tylko do odczytu. To ustawienie można zmienić później. Aby uzyskać więcej informacji, zobacz Oznaczanie lokalizacji zewnętrznej jako tylko do odczytu.
(Opcjonalnie) Jeśli lokalizacja zewnętrzna jest przeznaczona do migracji starszych obciążeń, kliknij pozycję Opcje zaawansowane i włącz tryb rezerwowy.
Zobacz Włączanie trybu rezerwowego w lokalizacjach zewnętrznych.
Kliknij pozycję Utwórz.
(Opcjonalnie) Powiąż lokalizację zewnętrzną z określonymi obszarami roboczymi.
Domyślnie każdy uprzywilejowany użytkownik może używać lokalizacji zewnętrznej w dowolnym obszarze roboczym dołączonym do magazynu metadanych. Jeśli chcesz zezwolić na dostęp tylko z określonych obszarów roboczych, przejdź do karty Obszary robocze i przypisz obszary robocze. Zobacz Przypisywanie lokalizacji zewnętrznej do określonych obszarów roboczych.
Przejdź do karty Uprawnienia, aby udzielić uprawnień do korzystania z lokalizacji zewnętrznej.
Aby każda osoba korzystała z lokalizacji zewnętrznej, musisz przyznać uprawnienia:
- Aby użyć zewnętrznej lokalizacji do dodania zarządzanej lokalizacji magazynu do metastore, katalogu lub schematu, przyznaj uprawnienie
CREATE MANAGED LOCATION. - Aby utworzyć tabele zewnętrzne lub woluminy, przyznaj
CREATE EXTERNAL TABLElubCREATE EXTERNAL VOLUME.
- Kliknij Grant.
- W oknie dialogowym dotyczącego
<external location>wybierz użytkowników, grupy lub podmioty usług w polu Principals i wybierz uprawnienie, które chcesz przyznać. - Kliknij Grant.
- Aby użyć zewnętrznej lokalizacji do dodania zarządzanej lokalizacji magazynu do metastore, katalogu lub schematu, przyznaj uprawnienie
Opcja 2. Tworzenie lokalizacji zewnętrznej przy użyciu języka SQL
Aby utworzyć lokalizację zewnętrzną przy użyciu języka SQL, uruchom następujące polecenie w notesie lub edytorze zapytań SQL. Zastąp wartości zastępcze.
-
<location-name>: nazwa lokalizacji zewnętrznej. Jeślilocation_namezawiera znaki specjalne, takie jak łączniki (-), musi być otoczony przez cudzysłowy odwrotne (` `). Zobacz Nazwy. -
<bucket-path>: ścieżka w dzierżawie chmury, do której ta lokalizacja zewnętrzna zapewnia dostęp. Na przykładr2://my-bucket@my-account-id.r2.cloudflarestorage.com. -
<storage-credential-name>: Nazwa poświadczenia magazynu danych uprawniającego do odczytu z zasobnika i zapisu do niego. Jeśli nazwa poświadczeń magazynu zawiera znaki specjalne, takie jak łączniki (-), musi być ujęta w apostrofy (` `).
CREATE EXTERNAL LOCATION [IF NOT EXISTS] `<location-name>`
URL '<bucket-path>'
WITH ([STORAGE] CREDENTIAL `<storage-credential-name>`)
[COMMENT '<comment-string>'];
Jeśli chcesz ograniczyć dostęp lokalizacji zewnętrznej do określonych obszarów roboczych na koncie, nazywanym również powiązaniem obszaru roboczego lub izolacją lokalizacji zewnętrznej, zobacz Przypisywanie lokalizacji zewnętrznej do określonych obszarów roboczych.