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.
Important
Pozyskiwanie uprawnień usługi OneLake jest w publicznej wersji zapoznawczej i podlega dodatkowym warunkom użytkowania dla Microsoft Azure wersji zapoznawczych. Aby zapoznać się z terminami wersji zapoznawczej specyficznymi dla tej funkcji, zobacz Funkcjonalność w wersji zapoznawczej. Informacje o terminach stosowanych podczas nawiązywania połączenia z zewnętrznymi źródłami danych znajdziesz w sekcji Zewnętrzne źródła danych.
Skonfiguruj indeksator OneLake lub indeksowane źródło wiedzy OneLake, aby zachować uprawnienia Microsoft OneLake. Usługa Foundry IQ (Wyszukiwanie AI platformy Azure) indeksuje metadane lokalizacji źródłowej, a nie listy ACL użytkowników i grup oraz używa usługi OneLake do oceny dostępu użytkownika żądającego w czasie wykonywania zapytania.
Ten artykuł uzupełnia Indeksowanie plików OneLake i Utwórz indeksowane źródło wiedzy OneLake o konfigurację specyficzną dla pozyskiwania uprawnień. Zarządzanie uprawnieniami źródła w Microsoft Fabric.
Ta wersja zapoznawcza jest obsługiwana tylko w chmurze publicznej Azure.
Prerequisites
- Obszar roboczy Fabric i magazyn danych z obsługiwanymi plikami w lokalizacji Pliki. Ukończ wymagania wstępne indeksatora OneLake.
- Usługa Foundry IQ w chmurze publicznej Azure z przypisaną przez system tożsamością zarządzaną na potrzeby uwierzytelniania wychodzącego w czasie zapytań do usługi OneLake. Przypisz tej tożsamości rolę Admin w obszarze roboczym Fabric.
- Wersja
2026-11-01-previewinterfejsu API REST dla konfiguracji uprawnień. Aby uzyskać kompletne żądanie REST, zobacz Tworzenie źródła wiedzy z zachowaniem uprawnień usługi OneLake.
Konfigurowanie indeksatora OneLake
W przypadku potoku indeksatora zarządzanego bezpośrednio dodaj następujące ustawienia do standardowej konfiguracji indeksowania usługi OneLake. Te ustawienia to dodatki do konfiguracji, a nie kompletne żądania utworzenia.
Ustaw
indexerPermissionOptionsw źródle danych, aby wybrać metadane lokalizacji źródłowej do pozyskiwania. WybierzoneLakeParentFoldersioneLakeLakehouseIdniezależnie w celu pozyskiwania. Poniższy fragment JSON wybiera oba elementy na potrzeby wyszukiwania uwzględniającego uprawnienia:{ "indexerPermissionOptions": [ "oneLakeParentFolders", "oneLakeLakehouseId" ] }Zdefiniuj odpowiednie pola w indeksie docelowym.
Metadane źródłowe Przykładowe pole docelowe Typ pola indeksu Wymagana konfiguracja pola metadata_onelake_parent_foldersonelake_parent_foldersCollection(Edm.String)filterable: true;permissionFilter: "oneLakeParentFolders".metadata_onelake_lakehouse_idonelake_lakehouse_idEdm.Stringfilterable: true;permissionFilter: "oneLakeLakehouseId".metadata_onelake_is_shortcutmetadata_onelake_is_shortcutEdm.BooleanPole najwyższego poziomu z adnotacją filterable: truei bez adnotacjipermissionFilter. Zachowaj tę nazwę pola.Identyfikator lakehouse identyfikuje skonfigurowany źródłowy lakehouse, a nie docelowy lakehouse skrótu.
Ustaw indeks
permissionFilterOptionnaenabledi skonfigurujoneLakeSecuritySourceprzy użyciu identyfikatorów źródłowego obszaru roboczego i lakehouse:{ "permissionFilterOption": "enabled", "oneLakeSecuritySource": { "fabricWorkspaceId": "<fabric-workspace-id>", "lakehouseId": "<lakehouse-id>" } }
Nie zamieniaj userIds ani groupIds na opcje uprawnień OneLake. Te pola reprezentują lokalizacje źródłowe, a nie skopiowane wpisy listy ACL użytkowników i grup.
Zachowaj wartości dostarczone przez źródło. Nie zastępuj ich danymi wyjściowymi umiejętności, funkcjami mapowania ani polami pochodzącymi z zawartości dokumentu.
Project pól do fragmentów
Gdy zestaw umiejętności tworzy fragmenty, mapuj wszystkie trzy pola metadanych na każdy fragment przez projekcje indeksu. Te mapowania projekcji wypełniają pola fragmentów bezpośrednio; nie potrzebujesz do tego elementu indexer fieldMappings.
Dodaj trzy pola z poprzedniej tabeli do indeksu fragmentów. Skonfiguruj
permissionFilterOptionioneLakeSecuritySourcetego indeksu zgodnie z wcześniejszym opisem.Dodaj następujący fragment do zestawu umiejętności. Używa on standardowego schematu indeksu fragmentów z polem
parent_idi umiejętnością dzielenia tekstu, która generuje/document/pages/*. Zachowaj inne mapowania zawartości podczas dostosowywania przykładu.{ "indexProjections": { "selectors": [ { "targetIndexName": "<chunk-index-name>", "parentKeyFieldName": "parent_id", "sourceContext": "/document/pages/*", "mappings": [ {"name": "chunk", "source": "/document/pages/*"}, { "name": "onelake_parent_folders", "source": "/document/metadata_onelake_parent_folders" }, { "name": "onelake_lakehouse_id", "source": "/document/metadata_onelake_lakehouse_id" }, { "name": "metadata_onelake_is_shortcut", "source": "/document/metadata_onelake_is_shortcut" } ] } ], "parameters": {"projectionMode": "skipIndexingParentDocuments"} } }
Za pomocą metody skipIndexingParentDocumentszapisujesz tylko fragmenty. Każdy zapisany indeks zawartości wymaga wszystkich trzech pól metadanych. Mapuj je bezpośrednio z odpowiednich /document/metadata_onelake_* źródeł pokazanych wcześniej w każdej projekcji zawartości.
Mapowanie pól na potrzeby indeksowania dokumentów
W przypadku pozyskiwania bez podziału na fragmenty lub oddzielnego indeksu nadrzędnego zgodne nazwy źródłowe i docelowe z kompatybilnymi typami są automatycznie mapowane.
Mapowania pól indeksatora służą tylko do zmieniania nazw tych pól metadanych, takich jak metadata_onelake_parent_folders na onelake_parent_folders oraz metadata_onelake_lakehouse_id na onelake_lakehouse_id w przykładowym schemacie.
metadata_onelake_is_shortcut Niezmieniona nazwa nie wymaga jawnego mapowania pól.
Dodanie pól uprawnień do istniejącego indeksu nie powoduje wypełnienia ich w dokumentach już indeksowanych. Po skonfigurowaniu pozyskiwania uprawnień ponownie przetwórz te dokumenty w celu wypełnienia wymaganych metadanych.
Konfigurowanie indeksowanego źródła wiedzy OneLake
Podczas tworzenia indeksowanego źródła wiedzy OneLake ustaw obie wartości w elemecie indexedOneLakeParameters.ingestionParameters.ingestionPermissionOptions:
{
"ingestionPermissionOptions": [
"oneLakeParentFolders",
"oneLakeLakehouseId"
]
}
Ten fragment JSON pokazuje tylko ustawienie uprawnień. W przeciwieństwie do opcji bezpośredniego źródła danych obie wartości muszą być podane łącznie do zabezpieczonego pozyskiwania indeksowanych danych OneLake. Aby zapoznać się z kompletnym przykładem tworzenia REST przy użyciu 2026-11-01-preview obu opcji uprawnień, zobacz Create a knowledge source with OneLake permission preservation (Tworzenie źródła wiedzy z zachowaniem uprawnień usługi OneLake).
Źródło wiedzy generuje pola indeksu, konfigurację uprawnień na poziomie indeksu, mapowania pól i projekcje fragmentów. Nie trzeba konfigurować tych wygenerowanych mapowań oddzielnie.
Po włączeniu pozyskiwania uprawnień usługi OneLake pomiń ustawienia magazynu zasobów, pamięci podręcznej wzbogacania i wyodrębniania grafów.
Wykonywanie zapytań przy użyciu tożsamości użytkownika żądającego
Użyj istniejącego przepływu zapytań listy ACL i testowania, w tym x-ms-query-source-authorization dla tokenu użytkownika wysyłającego żądanie. Użyj dla 2026-11-01-preview żądań obsługujących uprawnienia usługi OneLake zamiast wersji interfejsu API w tych udostępnionych przykładach. W przypadku bazy wiedzy postępuj zgodnie ze wspólnymi wskazówkami dotyczącymi autoryzacji w czasie wykonywania zapytań. Usługa OneLake nie wymaga oddzielnego protokołu zapytań.
Funkcja Search ocenia możliwe do odczytania foldery OneLake użytkownika względem wartości indeksowanych folderów nadrzędnych w skonfigurowanym lakehouse. Dopasowanie z bezpośrednim elementem nadrzędnym dokumentu lub folderem będącym przodkiem może sprawić, że dokument kwalifikuje się do pobrania. Uprawnienia źródłowe pozostają zarządzane w Fabric.
W przypadku Files/teamA/reports/document.txtwartości folderu indeksowanego to ["Files", "Files/teamA", "Files/teamA/reports"]. Nazwa pliku nie jest dołączona. Hierarchia zawiera foldery nadrzędne powyżej skonfigurowanego podfolderu pozyskiwania.
Ścieżki są względne względem lakehouse, używają / separatorów i nie mają wiodącego lub końcowego ukośnika. Dopasowanie uwzględnia wielkość liter. Zachowaj spacje, znaki Unicode i dosłowne znaki procentu w podanej postaci; nie dekoduj URI ani w inny sposób ponownie nie zapisuj tych wartości metadanych.
Uwzględnij uprawnienia i aktualność ścieżki
Indeksowane lokalizacje źródłowe i informacje o dostępie do czasu zapytania mogą ulec zmianie w różnym czasie. Zmiany uprawnień, w tym cofnięcia uprawnień, mogą zająć trochę czasu, aby wpłynąć na wyniki wyszukiwania; nie ma stałego, całościowego czasu aktualizacji.
Zapytania używają indeksowanej zawartości i autoryzacji w czasie wykonywania zapytań; nie wyzwalają uruchomienia indeksatora. Indeksatory zwykle są uruchamiane podczas tworzenia, chyba że są wyłączone, a następnie na żądanie lub zgodnie z harmonogramem. Zaplanowany czas lub żądanie uruchomienia nie jest terminem ukończenia. Zobacz sposób działania harmonogramu w przypadku opóźnionych lub pominiętych uruchomień.
| Etapie | Co może opóźnić zmianę |
|---|---|
| Fabric i OneLake | Propagacja ról obszaru roboczego, dostępu do elementów i uprawnień do folderów. |
| Uruchomienie indeksatora | Planowanie i zdolność wykonywania; zaplanowane lub żądane uruchomienie może nie rozpocząć się natychmiast. |
| Uruchomienie indeksatora | Czas trwania przetwarzania, ograniczanie przepustowości, ponawianie prób lub elementy, które zakończyły się niepowodzeniem. |
| Dostępność indeksu | Projekcja fragmentów, zapisy dokumentów i odświeżanie indeksu wpływają na to, kiedy zaktualizowana zawartość i metadane ścieżki stają się możliwe do wyszukania. |
| Tożsamość użytkownika wysyłającego żądanie | Świeżość tokenu i zmiany ról użytkownika lub członkostwa w grupach. |
| Dostęp w czasie wykonywania zapytania | Buforowane informacje o dostępie usługi OneLake mogą nadal odzwierciedlać wcześniejsze uprawnienia do czasu odświeżenia. Sam nowy token użytkownika nie usuwa buforowanych informacji. |
Użyj stanu indeksatora i historii wykonywania , aby sprawdzić czasy rozpoczęcia i zakończenia na poziomie uruchomienia, błędy, ostrzeżenia i elementy zakończone niepowodzeniem. Stan na najwyższym poziomie running oznacza, że indeksator jest gotowy do uruchomienia, a nie że jest aktualnie uruchomiony. Sprawdź reprezentatywne dokumenty i fragmenty pod kątem wymaganych metadanych. Pomyślne uruchomienie pozyskiwania nie oznacza, że propagacja w Fabric, tokeny użytkownika i buforowane informacje o dostępie również zostały odświeżone.
Po przeniesieniu, zmianie nazwy, usunięciu lub ponownym użyciu ścieżki sprawdź nieaktualne rekordy w starej lokalizacji, a także rekordy w nowej lokalizacji. Starsza zawartość indeksowana może pozostać skojarzona ze ścieżką, której bieżący dostęp uległ zmianie.
Przed fizycznym usunięciem pliku źródłowego należy użyć przepływu pracy usuwania nietrwałego usługi OneLake . Jeśli plik źródłowy został już usunięty, usuń ręcznie osierocone dokumenty wyszukiwania i fragmenty.
Postępuj zgodnie ze wskazówkami dotyczącymi uruchamiania i resetowania , aby ponownie przetworzyć pliki, które nadal istnieją. Zresetowanie indeksatora nie powoduje usunięcia indeksowanych dokumentów ani odświeżenia informacji o dostępie w czasie wykonywania zapytania.
Podczas sprawdzania poprawności zmiany uprawnień użyj nowych tokenów użytkownika i udostępnionego przepływu testowania listy ACL. Porównaj dozwolonego użytkownika i użytkownika z odmową dostępu oraz sprawdź zarówno dokumenty nadrzędne, jak i fragmenty, jeśli ma to zastosowanie. Nie używaj zakończenia importu jako miary zakończenia cofnięcia.
Poznaj granice uprawnień skrótów
Pobieranie z rozpoznawaniem uprawnień usługi OneLake nie obsługuje skrótów w tej wersji zapoznawczej. Zawartość pochodna skrótów jest wykluczona z wyników, w tym zawartość osiągana za pośrednictwem skrótów OneLake-to-OneLake i skrótów zewnętrznych. Dostęp do folderu zawierającego lub obiektu docelowego skrótu nie umożliwia pobierania zawartości skrótu.
Zwykła obsługa pozyskiwania skrótów jest oddzielona od pobierania uwzględniającego uprawnienia.
Wymagane metadata_onelake_is_shortcut pole rozróżnia zawartość pochodzącą ze skrótów od plików bezpośrednich. Zdefiniuj je jako pole najwyższego poziomu Edm.Boolean z filterable: true i bez adnotacji permissionFilter. Zachowaj nazwę tego pola i jego wartości dostarczone przez źródło. Brakujące wartości lub wartości null nie sprawiają, że dokument kwalifikuje się do wyników filtrowanych według uprawnień. Nie zastąp tego pola stałą wartością ani nie wywnioskuj tego na podstawie dostępu do folderu nadrzędnego.
Liczby, fasety, cytaty i ugruntowanie oparte na zawartości filtrowanej uprawnieniami nie są listą całej zawartości indeksowanej.
Rozwiązywanie problemów z pobieraniem uwzględniającym uprawnienia
W przypadku brakujących wyników przed użyciem udostępnionych wskazówek dotyczących rozwiązywania problemów sprawdź następujące warunki specyficzne dla źródła:
- Upewnij się, że istnieją trzy wymagane pola i mają pokazane wcześniej typy i atrybuty. W przypadku fragmentów sprawdź mapowania poszczególnych projekcji i ścieżki źródłowe.
- Sprawdź tożsamość zarządzaną przypisaną przez system usługi Foundry IQ oraz rolę administratora obszaru roboczego Fabric.
- Sprawdź, czy zawartość przeszła przez skrót. Wykluczenie skrótów jest ograniczeniem w wersji zapoznawczej, a nie brakiem uprawnienia do folderu nadrzędnego.
- Sprawdź świeżość ścieżki, wielkość liter i skonfigurowany magazyn lakehouse po przeniesieniu zawartości lub zmianie uprawnień.
- Jeśli ustalanie dostępu do usługi OneLake zakończy się niepowodzeniem z powodu uwierzytelniania, stronicowania, nieprawidłowej odpowiedzi lub rozpoznawania ścieżki, zapytanie zwróci błąd, zamiast kontynuować przy niepełnych informacjach o dostępie. Popraw dostęp do źródła lub konfigurację przed ponowieniem próby.
Limitations
Wbudowane umiejętności tekstowe i osadzania są obsługiwane przy użyciu pozyskiwania uprawnień OneLake. Obowiązują następujące ograniczenia wersji zapoznawczej:
- Zawartość pochodna skrótu jest wykluczona z pobierania uwzględniającego uprawnienia. Zobacz granice uprawnień skrótów.
- Po włączeniu jednej z opcji uprawnień OneLake buforowanie wzbogacania, magazyny wiedzy i niestandardowe umiejętności interfejsu API sieci Web nie są obsługiwane.
- umiejętności Chat Completion wymagają obsługiwanego punktu końcowego Microsoft obsługującego pozyskiwanie uprawnień usługi OneLake; punkty końcowe z domeną niestandardową i Azure API Management nie są obsługiwane. Jeśli włączysz również pozyskiwanie etykiet poufności, Chat Completion skills nie są obsługiwane w żadnym punkcie końcowym.