Uruchamianie zapytania za pomocą działania KQL

Działanie KQL w usłudze Data Factory dla usługi Microsoft Fabric umożliwia uruchomienie zapytania w języku zapytań Kusto (KQL) na instancji platformy Azure Data Explorer.

Wymagania wstępne

Aby rozpocząć pracę, należy spełnić następujące wymagania wstępne:

• Musisz mieć dostęp do dzierżawy usługi Microsoft Fabric z aprowizowaną pojemnością. Możesz wypróbować usługę Fabric z bezpłatną wersją próbną.
• Obszar roboczy Fabric przypisany do tej pojemności.

Dodaj działanie KQL do potoku za pomocą interfejsu użytkownika

Aby użyć działania KQL w potoku, wykonaj następujące kroki:

Tworzenie aktywności

1. Utwórz nowy rurociąg w obszarze roboczym.

2. Wyszukaj język KQL w okienku Działania potoku i wybierz go, aby dodać go do kanwy potoku.

   Uwaga

   Może być konieczne rozwinięcie menu i przewinięcie w dół, aby zobaczyć aktywność KQL wyróżnioną na poniższym zrzucie ekranu.

   

3. Wybierz nowe działanie KQL w edytorze potoków, jeśli nie zostało jeszcze wybrane.

   

Zapoznaj się ze wskazówkami dotyczącymi ustawień ogólnych, aby skonfigurować kartę Ustawienia ogólne.

Ustawienia działania KQL

1. Wybierz kartę Ustawienia , a następnie wybierz połączenie bazy danych KQL z listy rozwijanej lub utwórz nowe. Jeśli wybierzesz magazyn danych obszaru roboczego, możesz użyć zawartości dynamicznej, aby sparametryzować wybór bazy danych, wybierając opcję Dodaj zawartość dynamiczną wyświetlaną na liście rozwijanej.

2. Następnie podaj zapytanie KQL do wykonania w wybranej bazie danych dla właściwości Command. Możesz użyć zawartości dynamicznej w zapytaniu, wybierając link Dodaj zawartość dynamiczną wyświetlany po wybraniu pola tekstowego.

   

3. Na koniec określ limit czasu polecenia lub pozostaw domyślny limit czasu 20 minut. Możesz też użyć zawartości dynamicznej dla tej właściwości.

Zapisz i uruchom lub zaplanuj potok

Działanie KQL może być zwykle używane z innymi działaniami. Po skonfigurowaniu wszystkich innych czynności wymaganych dla potoku można potok zapisać i uruchomić lub zaplanować.

Przejdź do karty Narzędzia główne w górnej części edytora potoków i wybierz przycisk zapisz, aby zapisać potok. Wybierz pozycję Uruchom , aby uruchomić ją bezpośrednio, lub Zaplanuj , aby zaplanować przebiegi w określonych godzinach lub interwałach. Aby uzyskać więcej informacji na temat przebiegów potoków, zobacz: Planowanie przebiegów potoków.

Po uruchomieniu możesz monitorować wykonywanie potoku i wyświetlać historię uruchamiania na karcie Dane wyjściowe poniżej kanwy.

Znane ograniczenia

• Ograniczenie wdrażania między obszarami roboczymi: Gdy potok zawierający działanie KQL jest wdrażany w obszarach roboczych przy użyciu potoków wdrażania, właściwości połączonej usługi specyficzne dla obszaru roboczego nie są ponownie mapowane i nadal odwołują się do źródłowego obszaru roboczego. Może to spowodować niepowodzenie przebiegów potoku w docelowym obszarze roboczym z powodu błędów UserErrorKustoReadFailed lub EntityNotFoundException.

Obejście polega na użyciu zmiennych obszaru roboczego (biblioteki zmiennych) dla wszystkich właściwości połączenia specyficznych dla obszaru roboczego i odwoływania się do nich za pośrednictwem elementu endpointVariableLibrary, artifactIdVariableLibrary i workspaceIdVariableLibrary.

Powiązana zawartość

• Jak monitorować uruchomienia potoków