Omówienie interfejsu API usługi Azure Data Explorer

  • Artykuł

Usługa Azure Data Explorer obsługuje następujące punkty końcowe komunikacji:

  1. Punkt końcowy interfejsu API REST, za pomocą którego można wysyłać zapytania i zarządzać danymi w usłudze Azure Data Explorer. Ten punkt końcowy obsługuje język zapytań Kusto dla zapytań i poleceń zarządzania.
  2. Punkt końcowy MS-TDS, który implementuje podzestaw protokołu strumienia danych tabelarycznych (TDS) firmy Microsoft używany przez produkty programu Microsoft SQL Server. Punkt końcowy obsługuje usługi TDS w wersji 7.x i 8.0. Ten punkt końcowy jest użyteczny dla narzędzi, które wiedzą, jak komunikować się z punktem końcowym programu SQL Server w przypadku zapytań.
  3. Punkt końcowy usługi Azure Resource Manager (ARM) będący standardowym środkiem dla usług platformy Azure. Punkt końcowy służy do zarządzania zasobami, takimi jak klastry usługi Azure Data Explorer.

Interfejs API REST

Podstawowym środkiem komunikacji z dowolną usługą Azure Data Explorer jest użycie interfejsu API REST usługi. Ten w pełni udokumentowany punkt końcowy pozwala funkcjom wywołującym na wykonywanie następujących operacji:

  • Zapytania o dane
  • Zapytania o metadane i modyfikowanie ich
  • Pozyskiwanie danych
  • Zapytania o kondycję usługi
  • Zarządzanie zasobami

Różne usługi azure Data Explorer komunikują się między sobą za pośrednictwem tego samego publicznie dostępnego interfejsu API REST.

Dostępnych jest także wiele bibliotek klienta do korzystania z usługi bez konieczności stosowania protokołu interfejsu API REST.

MS-TDS

Usługa Azure Data Explorer obsługuje protokół komunikacyjny microsoft SQL Server (MS-TDS) i obejmuje ograniczoną obsługę uruchamiania zapytań T-SQL. Obsługiwane wersje ms-TDS obejmują 7.x i 8.0. Ten protokół umożliwia użytkownikom uruchamianie zapytań w usłudze Azure Data Explorer, korzystając z dobrze znanej składni zapytań (T-SQL) i jej narzędzi klienta bazy danych (takich jak LINQPad, sqlcmd, Tableau, Excel i Power BI).

Aby uzyskać więcej informacji, zobacz MS-TDS.

Biblioteki klienta

Usługa Azure Data Explorer udostępnia wiele bibliotek klienckich, które korzystają z powyższych punktów końcowych, aby ułatwić dostęp programowy.

  • Zestaw SDK .NET
  • Zestaw SDK dla języka Python
  • R
  • Zestaw SDK Java
  • Zestaw SDK dla języka Node
  • Zestaw SDK dla języka Go
  • PowerShell

Porada

Możesz użyć kreatora generatora przykładowych aplikacji, aby utworzyć działającą aplikację dostosowaną do klastra, aby pozyskiwać i wykonywać zapytania dotyczące danych w preferowanym języku programowania. Wygenerowany kod może służyć jako punkt odniesienia do pisania własnych aplikacji, zmieniania kodu zgodnie z rzeczywistym użyciem lub kopiowania sekcji kodu do własnych aplikacji. Aby uzyskać więcej informacji, zobacz przykładowy kreator generatora aplikacji.

Biblioteki platformy .NET Framework

.NET Framework Biblioteki są zalecanym sposobem programowego interakcji z klastrem. Dostępnych jest kilka różnych bibliotek.

Powyższe biblioteki używają interfejsów API platformy Azure, takich jak interfejs API usługi Azure Storage i interfejs API Microsoft Entra.

Biblioteki języka Python

Biblioteka klienta języka Python umożliwia obiektom wywołującym wysyłanie zapytań dotyczących danych i poleceń zarządzania. Aby uzyskać więcej informacji, zobacz Kusto Python SDK.

Biblioteka języka R

Biblioteka klienta języka R umożliwia obiektom wywołującym wysyłanie zapytań dotyczących danych i poleceń zarządzania. Aby uzyskać więcej informacji, zobacz Zestaw KUSTO R SDK.

Zestaw SDK Java

Biblioteka kliencka Języka Java zapewnia możliwość wykonywania zapytań względem klastrów przy użyciu języka Java. Aby uzyskać więcej informacji, zobacz Kusto Java SDK.

Zestaw SDK dla języka Node

Zestaw Node SDK jest zgodny z rozwiązaniem Node LTS (obecnie wersja 6.14) i jest kompilowany z systemem ES6. Aby uzyskać więcej informacji, zobacz Zestaw SDK platformy Kusto Node.

Zestaw SDK dla języka Go

Biblioteka klienta Języka Go umożliwia wykonywanie zapytań, kontrolowanie i pozyskiwanie do klastra przy użyciu języka Go. Aby uzyskać więcej informacji, zobacz Zestaw SDK Języka Golang Kusto.

PowerShell

Biblioteki .NET Framework mogą być używane przez skrypty programu PowerShell. Aby uzyskać więcej informacji, zobacz Use Kusto .NET client libraries from PowerShell (Korzystanie z bibliotek klienckich platformy Kusto .NET z programu PowerShell).

Integracja środowiska IDE narzędzia Monaco

Pakiet monaco-kusto obsługuje integrację z edytorem sieci Web Monaco. Edytor Monaco, opracowany przez firmę Microsoft, stanowi podstawę programu Visual Studio Code. Aby uzyskać więcej informacji, zobacz pakiet monaco-kusto.