Linki głębokie interfejsu użytkownika

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Linki głębokie interfejsu użytkownika to identyfikatory URI, które po otwarciu w przeglądarce internetowej powodują automatyczne otwarcie narzędzia interfejsu użytkownika (takiego jak Kusto.Explorer lub Kusto.WebExplorer) w sposób, który wstępnie wybierze żądany klaster Kusto (i opcjonalnie bazę danych).

Na przykład gdy użytkownik wybierze https://help.kusto.windows.net/Samples?query=print%20123pozycję , kusto.WebExplorer otworzy help.kusto.windows.net klaster, wybierz Samples bazę danych jako domyślną bazę danych i uruchom skojarzone zapytanie.

Linki głębokie interfejsu użytkownika działają, ponieważ przeglądarka użytkownika otrzymuje odpowiedź przekierowania podczas wystawiania żądania GET do identyfikatora URI i zależy od ustawień przeglądarki w celu umożliwienia przetwarzania tego przekierowania. (Na przykład link bezpośredni interfejsu użytkownika do aplikacji Kusto.Explorer wymaga skonfigurowania przeglądarki w celu umożliwienia uruchamiania aplikacji ClickOnce).

Link bezpośredni interfejsu użytkownika musi być prawidłowym identyfikatorem URI i ma następujący format:

https://Klaster / [DatabaseName] [? Parametry]

Gdzie:

• Klaster jest podstawowym adresem samego klastra. Ta część jest obowiązkowa, ale można ją zastąpić, określając parametr uri zapytania w obszarze Parametry.

• DatabaseName to nazwa bazy danych w klastrze , która ma być używana jako baza danych w zakresie. Jeśli ta właściwość nie jest ustawiona, narzędzie interfejsu użytkownika decyduje o tym, która baza danych ma być używana, jeśli w ogóle. (Jeśli zapytanie lub polecenie jest określone przez Parametry, zaleca się, aby wartość DatabaseName została uwzględniona w identyfikatorze URI.

• Parametry mogą służyć do określania innych parametrów w celu kontrolowania zachowania linku głębokiego interfejsu użytkownika. Parametry obsługiwane przez wszystkie narzędzia interfejsu użytkownika kusto "oficjalne" są wskazane w poniższej tabeli. Parametry specyficzne dla narzędzia są zanotowane w dalszej części tego dokumentu.

  Parametr	Opis
  web	Wybiera narzędzie interfejsu użytkownika. Domyślnie lub jeśli jest ustawiona wartość 1, jest używana wartość Kusto.WebExplorer. Jeśli ustawiono wartość 0, zostanie użyty program Kusto.Explorer. Jeśli ustawiono wartość 3, parametr Kusto.WebExplorer jest używany bez istniejących kart.
  query	Tekst polecenia zapytania lub zarządzania, który ma rozpoczynać się od podczas otwierania narzędzia interfejsu użytkownika.
  querysrc	Identyfikator URI wskazujący zasób internetowy, który zawiera tekst polecenia zapytania lub zarządzania, od którego należy rozpocząć pracę podczas otwierania narzędzia interfejsu użytkownika.
  name	Nazwa połączenia z klastrem.
  autorun	Jeśli jest ustawiona wartość false, wymaga, aby użytkownik aktywnie uruchamiał zapytanie zamiast autorunning go po kliknięciu linku.

  Wartość parametru może używać standardowego kodowania parametrów query zapytania HTTP. Alternatywnie można go kodować przy użyciu przekształcenia base64(gzip(text)), co umożliwia kompresowanie długich zapytań lub poleceń zarządzania do usługi Git w domyślnych limitach długości identyfikatora URI przeglądarki.

Przykłady

Oto kilka przykładów linków:

• https://help.kusto.windows.net/: Gdy agent użytkownika (na przykład przeglądarka) wysyła GET / żądanie, które jest przekierowywane do domyślnego narzędzia interfejsu użytkownika skonfigurowanego do wykonywania zapytań względem klastra help .
• https://help.kusto.windows.net/Samples: Gdy agent użytkownika (na przykład przeglądarka) wysyła GET /Samples żądanie, które jest przekierowywane do domyślnego narzędzia interfejsu użytkownika skonfigurowanego do wykonywania zapytań względem bazy danych klastra help Samples .
• http://help.kusto.windows.net/Samples?query=StormEvents: Gdy użytkownik (na przykład przeglądarka) wysyła GET /Samples?query=StormEvents żądanie, które jest przekierowywane do domyślnego narzędzia interfejsu użytkownika skonfigurowanego do wykonywania zapytań help względem bazy danych klastra Samples i wystawia StormEvents zapytanie.

Uwaga

Szczegółowe identyfikatory URI linku nie wymagają uwierzytelniania, ponieważ uwierzytelnianie jest wykonywane przez narzędzie interfejsu użytkownika używane do przekierowywania. Jeśli Authorization zostanie podany nagłówek HTTP, zostanie zignorowany.

Ważne

Ze względów bezpieczeństwa narzędzia interfejsu użytkownika nie wykonują automatycznie poleceń zarządzania, nawet jeśli query lub querysrc są określone w linku głębokim.

Głębokie łączenie z narzędziem Kusto.Explorer

Ten interfejs API REST wykonuje przekierowanie, które instaluje i uruchamia narzędzie klienckie Kusto.Explorer z specjalnie spreparowanych parametrów uruchamiania, które otwierają połączenie z określonym klastrem i wykonują zapytanie względem tego klastra.

Aby uzyskać opis składni identyfikatora URI przekierowania na potrzeby uruchamiania narzędzia Kusto.Explorer, zobacz Deep-linking with Kusto.Explorer (Łączenie głębokie za pomocą narzędzia Kusto.Explorer ).

Głębokie łączenie z usługą Kusto.WebExplorer

Oprócz wymienionych już parametrów zapytania w linkach bezpośrednich interfejsu użytkownika do kusto.WebExplorer mogą pojawić się następujące parametry:

Parametr	Opis
login_hint	Ustawia nazwę logowania użytkownika (adres e-mail) użytkownika.
tenant	Ustawia identyfikator dzierżawy firmy Microsoft dla użytkownika.

Aby poinstruować kusto.WebExplorer o zalogowaniu się użytkownika z innej dzierżawy firmy Microsoft Entra, określ login_hint i tenant dla użytkownika.

Przekierowanie to następujący identyfikator URI:

https://BaseAddress /clusters/ Klaster [/databases/ DatabaseName] [? Parametry]

Określanie zapytania lub polecenia zarządzania w identyfikatorze URI

Po określeniu parametru query ciągu zapytania identyfikatora URI musi zostać zakodowany zgodnie z regułami HTML kodowania ciągu zapytania identyfikatora URI. Alternatywnie tekst zapytania lub polecenia zarządzania można skompresować za pomocą narzędzia gzip, a następnie zakodowany za pomocą kodowania base64. Ta funkcja umożliwia wysyłanie dłuższych zapytań lub poleceń sterujących (ponieważ ta ostatnia metoda kodowania powoduje krótsze identyfikatory URI).

Określanie zapytania lub polecenia zarządzania przez pośredni

Jeśli zapytanie lub polecenie zarządzania jest długie, nawet kodowanie go przy użyciu biblioteki gzip/base64 może przekraczać maksymalną długość identyfikatora URI agenta użytkownika. Alternatywnie podano parametr querysrc ciągu zapytania identyfikatora URI, a jego wartość jest krótkim identyfikatorem URI wskazującym na zasób internetowy, który zawiera tekst polecenia zapytania lub zarządzania.

Na przykład ta wartość może być identyfikatorem URI pliku hostowanego przez usługę Azure Blob Storage.

Uwaga

Jeśli link bezpośredni to narzędzie interfejsu użytkownika aplikacji internetowej, usługa internetowa dostarczająca zapytanie lub polecenie zarządzania (czyli usługa dostarczająca querysrc identyfikator URI) musi być skonfigurowana do obsługi mechanizmu CORS dla programu dataexplorer.azure.com.

Ponadto jeśli informacje o uwierzytelnianiu/autoryzacji są wymagane przez usługę, muszą zostać podane jako część samego identyfikatora URI.

Jeśli na przykład querysrc wskazuje obiekt blob w usłudze Azure Blob Storage, należy skonfigurować konto magazynu tak, aby obsługiwało mechanizm CORS, i upublicznić sam obiekt blob (aby można go było pobrać bez oświadczeń zabezpieczeń) lub dodać odpowiednią sygnaturę dostępu współdzielonego usługi Azure Storage do identyfikatora URI. Konfigurację mechanizmu CORS można wykonać w witrynie Azure Portal lub w Eksplorator usługi Azure Storage. Zobacz Obsługa mechanizmu CORS w usłudze Azure Storage.