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.
Skróty OneLake w bazie danych KQL umożliwiają wysyłanie zapytań do danych w wewnętrznych elementach usługi Fabric i zewnętrznych magazynach danych bez przenoszenia tych danych. W bazie danych KQL każdy skrót pojawia się w sekcji Skróty i można go odpytywać jako tabelę zewnętrzną w zestawie zapytań KQL za pomocą funkcji external_table().
W tym artykule dowiesz się, jak utworzyć skrót OneLake w bazie danych KQL, który wskazuje na wewnętrzne źródła Fabric lub źródła zewnętrzne. Nie można zmieniać nazw skrótów utworzonych w bazie danych KQL i jednocześnie można utworzyć tylko jeden skrót.
Aby uzyskać ogólne informacje na temat typów skrótów, instrukcji specyficznych dla źródła i szerszych ograniczeń, zobacz Skróty OneLake.
Uwaga
Aby zwiększyć wydajność zapytań za pośrednictwem obsługiwanych skrótów, zobacz Przyspieszanie zapytań za pośrednictwem skrótów oneLake.
Wymagania wstępne
- Obszar roboczy z pojemnością obsługiwaną przez Microsoft Fabric.
- Baza danych KQL z uprawnieniami do edycji.
- Jezioro.
Aby uzyskać dostęp do danych w bazie danych KQL w innych środowiskach Microsoft Fabric, zobacz Jedna kopia logiczna.
Tworzenie skrótu
Przejdź do istniejącej bazy danych KQL.
Wybierz pozycję +>Nowy>skrót OneLake.
Wybieranie źródła
Bazy danych KQL obsługują skróty do wewnętrznych zasobów OneLake, takich jak bazy danych KQL, lakehouse’y i hurtownie danych, a także do zasobów zewnętrznych, takich jak Azure Data Lake Storage, Amazon S3 i Google Cloud Storage. Aby uzyskać pełną listę obsługiwanych typów skrótów i wskazówki dotyczące konfiguracji specyficzne dla źródła, zobacz Typy skrótów.
- W oknie Nowy skrót wybierz typ źródła, z którym chcesz nawiązać połączenie.
- Wypełnij wymagane szczegóły połączenia dla źródła, a następnie wybierz folder lub tabelę, którą chcesz uwidocznić w bazie danych KQL.
- Opcjonalnie: Aby włączyć przyspieszanie zapytań w nowym skrócie, ustaw Accelerate na On.
- Wybierz Utwórz.
Aby zapoznać się z obsługiwanymi scenariuszami i ograniczeniami, zobacz Przyspieszanie zapytań dla skrótów oneLake — omówienie.
Uwaga
- Można połączyć tylko jeden podfolder lub jedną tabelę na każdy skrót. Aby nawiązać połączenie z większą ilością danych, utwórz dodatkowe skróty.
- Nie można utworzyć skrótu do tabeli, która ma gwiazdkę (
*) w dowolnej nazwie kolumny. Zmień nazwy kolumn przed utworzeniem skrótu.
Po utworzeniu skrótu baza danych zostanie odświeżona automatycznie. Skrót zostanie wyświetlony w obszarze Skróty w okienku Eksplorator . Teraz możesz wykonywać zapytania dotyczące danych.
Organizowanie skrótów za pomocą folderów
Aby utworzyć podfolder lub przejść do istniejącego folderu:
- W panelu Eksploratora wykonaj jedną z następujących czynności:
- Kliknij prawym przyciskiem myszy skrót i wybierz polecenie Przenieś do folderu>+ Nowy folder.
- Możesz też wybrać wielokropek (...) obok określonego skrótu i wybrać pozycję Przenieś do folderu>+ Nowy folder lub wybierz istniejący folder.
- Kliknij prawym przyciskiem myszy skrót i wybierz polecenie Przenieś do folderu>+ Nowy folder.
- Aby utworzyć folder, wprowadź nazwę folderu i wybierz pozycję Utwórz. Skrót zostanie przeniesiony do nowego folderu.
- Aby przenieść więcej niż jeden skrót, wprowadź inną nazwę folderu lub wybierz menu rozwijane i zaznacz pola obok skrótów, które chcesz przenieść do tego samego folderu.
- Możesz również przenieść skróty do istniejącego folderu. W tym celu wybierz pozycję Przenieś do folderu, a następnie wybierz folder, do którego chcesz przenieść skrót, lub przeciągnij skrót do folderu i upuść go.
Uwaga
- Jeśli usuniesz podfolder, skróty w folderze nie zostaną usunięte, ale zostaną przeniesione z powrotem do folderu nadrzędnego.
- Podfolder jest automatycznie usuwany, gdy w folderze nie ma skrótów.
- Foldery można tworzyć według typu zasobu, a nazwa musi być unikatowa dla typu zasobu. Na przykład można mieć folder tabeli i folder skrótów o tej samej nazwie, ale nie można mieć dwóch folderów skrótów o tej samej nazwie.
Wyszukaj dane
Aby wysłać zapytanie o dane ze skrótu OneLake, użyj external_table() funkcji .
- 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.
- Zastąp symbol zastępczy nazwy tabeli elementem
external_table('<shortcut-name>'). - Wybierz pozycję Uruchom lub naciśnij Shift + Enter, aby uruchomić wybrane zapytanie.
Mapowanie typu danych
Mapowanie typów danych Delta Parquet na typy danych Eventhouse
Podstawowe typy danych Delta są odwzorowywane na skalarne typy danych Eventhouse, jak pokazano w poniższej tabeli. Aby uzyskać więcej informacji, zobacz Scalar data types (Typy danych skalarnych).
| typ Delta | Typ danych skalarnych usługi Eventhouse |
|---|---|
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 |
Automatyczna synchronizacja schematu
Schematy tabel dla tabeli skrótowej synchronizują się automatycznie, dzięki czemu dodawanie, usuwanie, zmiany nazw i zmiany typów w tabeli źródłowej są odzwierciedlane w skrótach bez konieczności ręcznych aktualizacji. To zachowanie jest domyślnie włączone. Aby ją wyłączyć, wykonaj następujące polecenie w bazie danych źródłowej:
.create-or-alter external table ExternalTable
kind=delta
(
h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)
Więcej informacji o zachowaniu synchronizacji schematu można znaleźć w artykule Automatyczna synchronizacja schematu.