Tworzenie skrótów OneLake w bazie danych KQL

OneLake to jedno, ujednolicone, logiczne jezioro danych dla usługi Microsoft Fabric do przechowywania magazynów, magazynów, baz danych KQL i innych elementów. Skróty są osadzonymi odwołaniami w usłudze OneLake, które wskazują lokalizacje magazynu innych plików bez przenoszenia oryginalnych danych. Osadzone odwołanie sprawia, że wygląda na to, że pliki i foldery są przechowywane lokalnie, ale w rzeczywistości; istnieją w innej lokalizacji magazynu. Skróty można aktualizować lub usuwać z elementów, ale te zmiany nie mają wpływu na oryginalne dane i jego źródło.

Z tego artykułu dowiesz się, jak utworzyć skrót OneLake w bazie danych KQL, która wskazuje wewnętrzną sieć szkieletową lub źródła zewnętrzne. Ten rodzaj skrótu jest później używany do wykonywania zapytań w zestawach zapytań KQL przy użyciu external_table() funkcji . Nie można zmienić nazw skrótów utworzonych w bazie danych KQL i jednocześnie można utworzyć tylko jeden skrót.

Oprócz tworzenia skrótów z bazy danych KQL skróty można również tworzyć na podstawie innych elementów sieci szkieletowej. Te skróty wskazują również dane przechowywane w wewnętrznej sieci szkieletowej lub źródłach zewnętrznych, ale mają różne ograniczenia i są dostępne inaczej. Aby uzyskać więcej informacji, zobacz OneLake shortcuts (Skróty onelake).

Uwaga

Użyj skrótów OneLake, gdy chcesz często uruchamiać zapytania dotyczące danych historycznych bez partycjonowania lub indeksowania danych. Jeśli chcesz często uruchamiać zapytania i przyspieszać wydajność, zaimportuj dane bezpośrednio do bazy danych KQL.

Wybierz kartę odpowiadającą skrótowi, który chcesz utworzyć:

Skrót oneLake

Wymagania wstępne

• Obszar roboczy z pojemnością z włączoną usługą Microsoft Fabric
• Baza danych KQL z uprawnieniami do edycji
• A Lakehouse

Aby uzyskać dostęp do danych w bazie danych KQL w innych środowiskach usługi Microsoft Fabric, zobacz Jedną kopię logiczną.

Utwórz skrót

Uwaga

Poniższy przepływ przedstawia sposób tworzenia skrótu wskazującego dane w usłudze Lakehouse w usłudze Fabric. Podobnie można tworzyć skróty wskazujące magazyny danych lub inne bazy danych KQL.

1. Przejdź do istniejącej bazy danych KQL.

2. Wybierz pozycję Nowy>skrót OneLake.

   

Wybieranie źródła

1. W obszarze Źródła wewnętrzne wybierz pozycję Microsoft OneLake.

   

2. Wybierz źródło danych, z którym chcesz nawiązać połączenie, a następnie wybierz pozycję Dalej.

   

3. Rozwiń węzeł Tabele i wybierz określoną tabelę do nawiązania połączenia.

   

4. Wybierz pozycję Utwórz.

Uwaga

Można połączyć się tylko z jednym podfolderem lub tabelą na skrót. Aby nawiązać połączenie z większą ilością danych, powtórz te kroki i utwórz dodatkowe skróty.

Azure Data Lake Storage Gen2

Wymagania wstępne

• Obszar roboczy z pojemnością z włączoną usługą Microsoft Fabric
• Baza danych KQL z uprawnieniami do edycji
• Konto usługi Azure Data Lake Storage Gen2.

Utwórz skrót

1. Przejdź do istniejącej bazy danych KQL.

2. Wybierz pozycję Nowy>skrót OneLake.

   

Wybieranie źródła

1. W obszarze Źródła zewnętrzne wybierz pozycję Azure Data Lake Storage Gen2.

2. Wprowadź ustawienia Połączenie ion zgodnie z następującą tabelą:

   

   Pole	Opis	Wartość
   Adres URL	Parametry połączenia dla kontenera delty.	https://StorageAccountName.dfs.core.windows.net
   Połączenie	Wcześniej zdefiniowane połączenia dla określonej lokalizacji magazynu są wyświetlane na liście rozwijanej. Jeśli nie istnieją żadne połączenia, utwórz nowe połączenie.	Utwórz nowe połączenie.
   Nazwa połączenia	Nazwa połączenia usługi Azure Data Lake Storage Gen2.	Nazwa połączenia.
   Rodzaj uwierzytelniania	Model autoryzacji. Obsługiwane modele to: konto organizacyjne, klucz konta, sygnatura dostępu współdzielonego (SAS) i jednostka usługi. Aby uzyskać więcej informacji, zobacz Skróty usługi ADLS.	Zależne od modelu autoryzacji. Po wybraniu rodzaju uwierzytelniania wypełnij wymagane poświadczenia.

3. Wybierz Dalej.

4. Przejdź do lokalizacji docelowej skrótu.

   

   Jeśli właśnie użyto konta magazynu w adresie URL połączenia, wszystkie dostępne kontenery będą wyświetlane w widoku nawigacji po lewej stronie. Jeśli określono kontener w adresie URL połączenia, tylko określony kontener i jego zawartość będą wyświetlane w widoku nawigacji.

   Przejdź do konta magazynu, wybierając folder lub klikając marchew rozszerzenia obok folderu.

   W tym widoku można wybrać co najmniej jedną lokalizację docelową skrótu. Wybierz lokalizacje docelowe, klikając pole wyboru obok folderu w widoku nawigacji po lewej stronie.

5. Wybierz Dalej

   

   Strona przeglądu umożliwia zweryfikowanie wszystkich wybranych opcji. W tym miejscu można zobaczyć każdy skrót, który zostanie utworzony. W kolumnie akcji możesz kliknąć ikonę ołówka, aby edytować nazwę skrótu. Możesz kliknąć ikonę kosza, aby usunąć skrót.

6. Wybierz pozycję Utwórz.

Amazon S3

Wymagania wstępne

• Obszar roboczy z pojemnością z włączoną usługą Microsoft Fabric
• Baza danych KQL z uprawnieniami do edycji
• Konto Amazon S3. Aby uzyskać więcej informacji, zobacz Co to jest Amazon S3?

Utwórz skrót

1. Przejdź do istniejącej bazy danych KQL.

2. Wybierz pozycję Nowy>skrót OneLake.

   

Wybieranie źródła

1. W obszarze Źródła zewnętrzne wybierz pozycję Amazon S3.

2. Wprowadź ustawienia Połączenie ion zgodnie z następującą tabelą:

   

   Pole	Opis	Wartość
   Adres URL	Parametry połączenia zasobnika Amazon S3.	https://BucketName.s3.RegionCode.amazonaws.com
   Połączenie	Wcześniej zdefiniowane połączenia dla określonej lokalizacji magazynu są wyświetlane na liście rozwijanej. Jeśli nie istnieją żadne połączenia, utwórz nowe połączenie.	Tworzenie nowego połączenia
   Nazwa połączenia	Nazwa połączenia Amazon S3.	Nazwa połączenia.
   Rodzaj uwierzytelniania	Zasady zarządzania tożsamościami i dostępem (IAM). Zasady muszą mieć uprawnienia do odczytu i listy. Aby uzyskać więcej informacji, zobacz Użytkownicy IAM.	Zależne od zasad zasobnika.
   Identyfikator klucza dostępu	Klucz użytkownika zarządzanie tożsamościami i dostępem (IAM). Aby uzyskać więcej informacji, zobacz Zarządzanie kluczami dostępu dla użytkowników IAM.	Klucz dostępu.
   Klucz dostępu tajnego	Klucz tajny zarządzanie tożsamościami i dostępem (IAM).	Klucz tajny.

Wybierz Dalej.

1. Przejdź do lokalizacji docelowej skrótu.

   

   Jeśli użyto globalnego punktu końcowego w adresie URL połączenia, wszystkie dostępne zasobniki będą wyświetlane w widoku nawigacji po lewej stronie. Jeśli użyto określonego punktu końcowego zasobnika w adresie URL połączenia, tylko określony zasobnik i jego zawartość będą wyświetlane w widoku nawigacji.

   Przejdź do konta magazynu, wybierając folder lub klikając marchew rozszerzenia obok folderu.

   W tym widoku można wybrać co najmniej jedną lokalizację docelową skrótu. Wybierz lokalizacje docelowe, klikając pole wyboru obok folderu w widoku nawigacji po lewej stronie.

2. Wybierz Dalej

   

   Strona przeglądu umożliwia zweryfikowanie wszystkich wybranych opcji. W tym miejscu można zobaczyć każdy skrót, który zostanie utworzony. W kolumnie akcji możesz kliknąć ikonę ołówka, aby edytować nazwę skrótu. Możesz kliknąć ikonę kosza, aby usunąć skrót.

3. Wybierz pozycję Utwórz.

Baza danych jest odświeżona automatycznie. Skrót zostanie wyświetlony w obszarze Skróty w okienku Eksplorator .

Utworzono skrót OneLake. Teraz możesz wykonywać zapytania dotyczące tych danych.

Zapytania o dane

Aby wysłać zapytanie o dane ze skrótu OneLake, użyj external_table() funkcji .

1. Po prawej stronie bazy danych wybierz pozycję Eksploruj dane. Zostanie otwarte okno z kilkoma przykładowymi zapytaniami, które można uruchomić, aby uzyskać początkowe spojrzenie na dane.
2. Zastąp symbol zastępczy external_table('nazwy tabeli nazwą') skrótu.
3. Wybierz pozycję Uruchom lub naciśnij klawisze Shift + Enter, aby uruchomić wybrane zapytanie.

Mapowanie typów danych

Mapowanie typów danych obiektu delta parquet na typy danych domu zdarzeń

Typy danych pierwotnych delty są mapowane na typy danych skalarnych domu zdarzeń przy użyciu następujących reguł. Aby uzyskać więcej informacji na temat typów danych domu zdarzeń, zobacz Scalar data types (Typy danych skalarnych).

Typ różnicy	Typ danych skalarnych domu zdarzeń
string	string
long	long
integer	int
short	int
byte	real
float	real
double	real
decimal	decimal
boolean	bool
binary	string
date	datetime
timestamp_ntz (bez strefy czasowej)	datetime
struct	dynamic
array	dynamic
map	dynamic

Powiązana zawartość

• Wykonywanie zapytań dotyczących danych w zestawie zapytań KQL
• Funkcja external_table()