Kusto 取り込みライブラリの概要

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー

Kusto 取り込みライブラリは、データベースにデータを取り込むためのクライアントを提供します。 ライブラリは、 キューに および 直接 インジェストをサポートします。 取り込み方法は、Kusto 取り込みクライアント オブジェクトによって定義されます。

インターフェイスとクラスの一覧については、「 Kusto Ingest クライアント リファレンスを参照してください。

ライブラリの入手

優先する言語のタブを選択します。

アクセス許可

既存のテーブルにデータを取り込むには、少なくとも Database Ingestor または Table Ingestor のアクセス許可が必要です。 テーブルを作成するには、少なくともデータベース ユーザーのアクセス許可が必要です。 詳細については、ロールベースのアクセス制御に関するページを参照してください。

キューによるインジェスト

キューに入った取り込みクライアントは、インジェスト サービス上のクライアント コードの依存関係を最小限に抑えます。 このモードでは、インジェスト メッセージを Azure キューに送信することでインジェストが実行されます。このメッセージは、その後インジェスト サービスによって処理されます。 中間ストレージ項目が必要な場合、インジェスト クライアントはインジェスト サービスによって提供されるリソースを使用して生成されます。

キューに置かれたインジェストを使用すると、インジェスト サービスが使用できない場合にインジェスト要求を永続化でき、インジェスト サービスはデータベースのインジェスト負荷を管理できます。 このメソッドは、すべてのインジェスト要求の進行状況と結果を追跡し、一時的な障害に対するインジェストを再試行し、受信データの効率的で制御可能な集計によってパフォーマンスを向上させるメカニズムを提供します。

直接インジェスト

直接取り込みクライアントでは、インジェスト サービスと直接やり取りする必要があります。 このモードでは、インジェスト サービスはデータをモデレートまたは管理しません。 すべてのインジェスト要求は、サービスで直接実行されるコマンドに変換されます。 同期メソッドを使用する場合、メソッドの完了はインジェスト操作の終了を示します。

直接インジェストは待機時間が短く、集計は必要ありません。 ただし、クライアント コードは再試行またはエラー処理ロジックを実装する必要があり、クライアント コードは容量を認識していないので、要求でデータベースを圧倒する可能性があります。