KQL データベースを作成する
Real-Time Intelligenceでは、イベントハウス、データベース、テーブルのコンテキストでデータを操作します。 1 つのワークスペースに複数のデータベースを保持でき、イベントハウスに複数のデータベースを保持でき、各データベースには複数のテーブルを保持できます。
この記事では、KQL データベースを作成する方法について説明します。 KQL データベースにデータが保持されると、KQL クエリセットの Kusto 照会言語を使用してデータのクエリを実行できます。
前提条件
新しい KQL データベースを作成する
新しい KQL データベースを作成するには、Eventhouse エクスプローラーで次のいずれかを実行します。
[Eventhouse] を選択し、[新しいデータベース + ] を選択します。
[ KQL データベース] で +
データベース名を入力し、データベースの種類として [新しいデータベース ] (既定) または [新しいショートカット データベース (フォロワー)] を選択し、[作成] を選択します。 フォロワー データベースの詳細については、「データベース ショートカットの作成」を参照してください。
Note
データベース名には、英数字、アンダースコア、ピリオド、ハイフンを含めることができます。 特殊文字はサポートされていません。
KQL データベースは、選択したイベントハウスのコンテキスト内に作成されます。
KQL データベースを調べる
新しい KQL データベースを作成すると、KQL クエリを使用して KQL データベースを探索および管理するためのアタッチされた環境が自動的に作成されます。 詳細については、KQL の概要を参照してください。
クエリ環境にアクセスするには、KQL データベース オブジェクト ツリーからKQLdatabasename_querysetを選択します。
クエリ環境の名前を変更するには、名前の 横にある鉛筆アイコン を選択し、新しい名前を入力します。
データベースの詳細
KQL データベースのメイン ページには、データベースの内容の概要が表示されます。 次の表に、中央と右側の情報ウィンドウで使用可能な情報を示します。
データベースの右ペインの詳細
右側の情報ウィンドウには、選択したデータベースの詳細が表示されます。
Card | Item | 説明 |
---|---|---|
[サイズ] | ||
Compressed | 圧縮データの合計サイズ。 | |
元のサイズ | 圧縮を解除されたデータの合計サイズ。 | |
OneLake | ||
可用性 | OneLake の可用性を [オン] または [オフ] に設定します。 OneLake の可用性が有効になっている場合、テーブルの名前を変更することはできません。 | |
Latency | OneLake のテーブル間でデータを使用できるようになるまでの最大時間。 | |
テーブル番号 | OneLake で使用できるテーブルの数。 | |
OneLake フォルダー | ショートカットの作成に使用できる OneLake フォルダー パス。 | |
概要 | ||
作成者 | データベースを作成したユーザーのユーザー名 (使用可能な場合)、およびデータベースの作成日。 | |
リージョン | 容量がホストされているリージョンを表示します。 詳細については、「Fabric が使用できるリージョン」を参照してください。 | |
クエリ URI | クエリまたは管理コマンドの実行に使用される URI。 | |
インジェスト URI | 最後のデータ インジェストの日付と、データの取得に使用できる URI。 | |
キャッシュ ポリシー | データがキャッシュされ、ローカル SSD ストレージに保持される期間。 詳細については、キャッシュ ポリシーに関するページを参照してください。 | |
保持ポリシー | テーブルまたは具体化されたビューからデータが自動的に削除される期間。 詳細については、「データ保持ポリシー」を参照してください。 |
データベース センターの情報ウィンドウ
中央のデータベース情報ペインには、インジェスト データのヒストグラム、テーブル情報、およびデータベース インジェスト情報をプレビューする手段が表示されます。
Card | Item | 説明 |
---|---|---|
ヒストグラム | ||
行数 | 選択した時間範囲内のデータベースに読み込まれた行の数。 | |
最後の実行 | ヒストグラムが最後に生成された時刻。 | |
Interval | ヒストグラム表示の間隔を設定します。 間隔を 1 時間、6 時間、1 日、3 日、7 日、30 日で設定します。 | |
最新のステータスに更新 | ヒストグラムを更新します。 | |
ヒストグラム | インジェスト ヒストグラムには、選択した間隔でデータが表示されます。 間隔は完全な協定世界時 (UTC) 日で計算されますが、現地時刻に従って表示されます。 | |
テーブル | ||
テーブルを検索する | データベース テーブルを検索します。 | |
新しいテーブル | 新しいテーブルの作成 | |
テーブルの表示 | カード別またはリスト ビュー別にテーブル情報を表示します。 カードとリスト ビューには、テーブル名、圧縮サイズ、最終インジェスト、OneLake の可用性または待機時間の両方が表示されます。 カードには、過去 7 日間のデータベース インジェストのヒストグラム、前回のインジェストで取り込まれた行数、テーブル作成者プロファイルが一意に表示されます。 リスト ビューの表示には、行数、キャッシュ、保持期間の合計も表示されます。 |
|
データのプレビュー | ||
データのプレビュー | 各テーブルに取り込まれた過去 100 件のレコードのプレビューを表示します。 インジェスト時間、TableName、およびレコードを表示します。 ピボット ビューの列と値を選択するには、[列] を選択します。 |
テーブル詳細
KQL データベース内のテーブルを選択すると、テーブルの概要が表示されます。 次の表に、中央と右側の情報ウィンドウで使用可能な情報を示します。
テーブルの右ペインの詳細
右側の情報ウィンドウには、選択したテーブルの詳細が表示されます。
Card | Item | 説明 |
---|---|---|
[サイズ] | ||
Compressed | 圧縮データの合計サイズ。 | |
元のサイズ | 圧縮を解除されたデータの合計サイズ。 | |
OneLake | ||
可用性 | OneLake の可用性を [オン] または [オフ] に設定します。 OneLake の可用性が有効になっている場合、テーブルの名前を変更することはできません。 | |
Latency | OneLake でテーブル データを使用できるようになるまでの最大時間。 | |
Since | 可用性が記録された開始時刻。 | |
OneLake フォルダー | ショートカットの作成に使用できる OneLake フォルダー パス。 | |
概要 | ||
行数 | テーブルが含む行数。 | |
最後の 24 時間に取り込まれた行 | 過去 24 時間以内に取り込まれた行の数。 | |
最後に変更されたスキーマ | スキーマが最後に変更されたときと、誰が変更したか。 | |
インジェスト URI | 最後のデータ インジェストの日付と、データの取得に使用できる URI。 | |
キャッシュ ポリシー | データがキャッシュされ、ローカル SSD ストレージに保持される期間。 詳細については、キャッシュ ポリシーに関するページを参照してください。 | |
保持ポリシー | テーブルまたは具体化されたビューからデータが自動的に削除される期間。 詳細については、「データ保持ポリシー」を参照してください。 |
テーブル センターの情報ウィンドウ
中央のデータベース情報ペインには、インジェスト データのヒストグラム、テーブル情報、およびデータベース インジェスト情報をプレビューする手段が表示されます。
Card | Item | 説明 |
---|---|---|
ヒストグラム | ||
行数 | データベースに取り込まれた行の数。 | |
最後の実行 | ヒストグラムが最後に生成された時刻。 | |
Interval | ヒストグラム表示の間隔を設定します。 間隔を 1 時間、6 時間、1 日、3 日、7 日、30 日間隔で設定します。 間隔は完全な協定世界時 (UTC) 日で計算されますが、現地時刻に従って表示されます。 | |
最新のステータスに更新 | ヒストグラムを更新します。 | |
ヒストグラム | インジェスト ヒストグラムには、選択した間隔でデータが表示されます。 | |
データのプレビュー | ||
クイック クエリ | テーブル インジェストの結果のプレビューを表示します。 インジェスト時間、TableName、およびレコードを表示します。 ピボット ビューの列と値を選択するには、[列] を選択します。 | |
スキーマの分析情報 | ||
列 | テーブル内の各列について、日付範囲、最小値と最大値、一意の値の数など、列の値に関する分析情報を表示します。 | |
top 10 | [列] セクションに一覧表示されている列を選択すると、その列の上位 10 個の値が表示されます。 |