クエリ パラメーターの使用

Knowledge Studio のクエリはクエリ パラメーターをサポートしています。 一度作成されたクエリは静的であり、クエリのパラメーターによってクエリの一部を動的にすることができます。 クエリ パラメーターは、クエリが実行されるときに値が定義されるクエリの変数です。 これにより、ユーザーはクエリを変更せずに、別の値を使用して同じクエリを実行できるようになります。

たとえば、人に直接関連するすべてのエンティティを検索するクエリを作成できます: MATCH (p:Person)-[]-(n) WHERE p.Name = "John Doe" RETURN n。 クエリ パラメーターは、John Doe を、任意の名前に構成できる変数 $name に置き換えます: MATCH (p:Person)-[]-(n) WHERE p.Name = $name RETURN n。 クエリ ビューの [パラメーター] ウィンドウでは、$name パラメーターを定義し、クエリを変更せずに値を変更できます。

パラメーターのタイプ	説明
String	英数字のセット。
番号	Big Integer を除く任意の数値タイプのグラフ プロパティと一致します。 注意: Knowledge Studio は、-9007199254740991 (最小) から 9007199254740991 (最大) までの安全な整数のみをサポートします。 この範囲外の数値は、丸め処理のために不正確になってしまうため、ナレッジ グラフの Big Integer フィールドと一致しません。
ジオメトリ	計算式でサポートされている空間演算子のいずれかで使用するジオメトリを設定します。 現時点では四角形のジオメトリのみをサポートしています。
Date Only	日付のみで時間のない値。 クエリでの日時値の使用の詳細
Time Only	秒までの時間のみで日付のない値。 クエリでの日時値の使用の詳細
Date	精度が秒 (低精度) またはミリ秒 (高精度) までの日付と時間の値。 クエリでの日時値の使用の詳細
Timestamp Offset	協定世界時 (UTC) ゾーンの日付、時間、オフセット。 クエリでの日時値の使用の詳細
エンティティ	ナレッジ グラフ内のエンティティ。
リレーションシップ	ナレッジ グラフ内のリレーションシップ。

新規パラメーターの構成

構成パネルでは、クエリ内のパラメーターを定義および初期化できます。 クエリで使用される各パラメーターは、クエリを実行できるように構成する必要があります。 パラメーターには次のいずれかのタイプを選択できます。

文字列パラメーター

[文字列] パラメーターを構成します。

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [文字列] を選択します
6. パラメーターの初期の [値] として使用する文字列を入力ボックスに入力します。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。
7. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

数値パラメーター

[数値] パラメーターを構成

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [数値] を選択します
6. パラメーターの初期の [値] として使用する数値を入力ボックスに入力します。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。
7. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

ジオメトリ パラメーター

[ジオメトリ] パラメーターを構成します。

計算式の空間演算子の詳細。

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [ジオメトリ] を選択します
6. [ジオメトリの設定] をクリックして、パラメーターの初期の [値] を定義します。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。 。

   ジオメトリ スケッチ モードが開きます。

7. グラフィックス ツールバーの四角形ツールをクリックします。
8. マップ上でクリックおよびドラッグして、対象地域に四角形を描画します。

   ジオメトリのリストを構成する場合は、この手順をジオメトリごとに実行します。

9. 必要に応じて、グラフィックス ツールバーで次のいずれかの方法を使用してジオメトリを選択します。
   • [フィーチャの選択] - フィーチャをクリックして選択します。
   • [四角形による選択] - マップをクリックし、フィーチャ上に四角形をドラッグして選択します。
   • [なげなわによる選択] - マップまたはリンク チャートをクリックし、ポインターでフリーハンド図形を描画して選択します。
10. 必要に応じて、フィーチャを変更または削除します。
    • フィーチャのサイズを変更するには、端または隅にある四角形の 1 つをクリックし、ドラッグしてサイズを変更します。
    • フィーチャを移動するには、フィーチャ内の任意の場所をクリックし、マップ上の新しい位置にドラッグします。
    • グラフィックス ツールバーの [フィーチャの削除] をクリックして、フィーチャを削除します。
    • [消去] をクリックして、マップの内容をリセットします。
11. [OK] をクリックします。
12. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

Date Only

[日付のみ] パラメーターを構成します。

クエリでの日時値の使用の詳細

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [日付のみ] を選択します
6. [値] に使用する日付を設定します。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。 次のいずれかの方法で、日付を定義します。
   • 入力ボックスに日付を MM/DD/YYYY 形式で入力します。
   • 入力ボックスをクリックし、カレンダーを使用して日付を選択します。
7. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

Time Only

[時間のみ] パラメーターを構成します。

クエリでの日時値の使用の詳細

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [時間のみ] を選択します
6. 値に使用する時間を設定します。 。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。 次のいずれかの方法で、時間を定義します。
   • 入力ボックスに時間を HH:MM:SS.SSS 形式で入力します。
   • 必要に応じて、時間ピッカーを使用して時間を定義します。
7. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

Date

[日付] パラメーターを構成します。

クエリでの日時値の使用の詳細

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [日付] を選択します
6. [値] の日付と時刻を設定します。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。 次のいずれかの方法で、日付を定義します。
   • 入力ボックスに日付を MM/DD/YYYY 形式で入力します。
   • 入力ボックスをクリックし、カレンダーを使用して日付を選択します。
7. 次のいずれかの方法で、時間を定義します。
   • 入力ボックスに時間を HH:MM:SS.SSS 形式で入力します。
   • 必要に応じて、時間ピッカーを使用して時間を定義します。
8. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

タイムスタンプ オフセット パラメーター

[タイムスタンプ オフセット] パラメーターを構成します。

クエリでの日時値の使用の詳細

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [タイムスタンプ オフセット] を選択します
6. [値] の日付、時間、UTC オフセットを設定します。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。 次のいずれかの方法で、日付を定義します。
   • 入力ボックスに日付を MM/DD/YYYY 形式で入力します。
   • 入力ボックスをクリックし、カレンダーを使用して日付を選択します。
7. 次のいずれかの方法で、時間を定義します。
   • 入力ボックスに時間を HH:MM:SS.SSS 形式で入力します。
   • 必要に応じて、時間ピッカーを使用して時間を定義します。
8. タイム ゾーン オフセットの分数を UTC オフセット (分) で入力します。

   デフォルトは 0 です。 最小値は -720 (-12:00 時間)、最大値は 840 (+14:00 時間)です。

9. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

エンティティまたはリレーションシップ

[エンティティ] または [リレーションシップ] パラメーターを構成します。 エンティティまたはリレーションシップ パラメーターを構成するには、エンティティまたはリレーションシップの一意識別子をパラメーターとして使用します。

例: MATCH (p:Person)-[]-(m) WHERE ID(p) = $entityOrRelationshipUniqueID

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. [新しいパラメーターの作成] をクリックします

   新しい [パラメーター] フォームが開きます。

3. パラメーターに名前を付けます。
   1. [パラメーター] 見出しの横にあるオプション メニュー をクリックします。
   2. [名前の変更] をクリックします。
   3. [タイトル] ボックスにパラメーターを説明する名前を入力します。
   4. [適用] をクリックします。

   パラメーターの見出しは新しい名前に更新されます。

4. 次のいずれかの方法を使用して、[bind パラメーター] 入力でパラメーターを定義します。
   • 入力ボックスに、パラメーターの名前を入力します。
   • パラメーターを含む検索式を作成した場合は、ドロップダウンからそのパラメーターを選択します。
5. [タイプ] ドロップダウンから [エンティティ] または [リレーションシップ] を選択します。
6. 入力ボックスにエンティティの名前の入力を開始し、[値] に使用するエンティティまたはリレーションシップを定義します。 デフォルトは [単一の値] です。パラメーターの値のリストを設定するには、「値のリストの定義」をご参照ください。

   一致した上位 5 個のレコードを含むドロップダウン リストが表示されます。 入力するとリストが更新されます。

7. ドロップダウン リストからレコードを選択します。
8. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

パラメーター値のリストの使用

どのパラメーターも値のリストに指定できますが、リストには 1 種類の値のみを含めることができます。 たとえば、共通の姓を持つすべての人々を検索するには、計算式 MATCH (p:People) where n.lastName in $lastNameList RETURN n を使用し、パラメーター ウィンドウを使用して、Smith、Jones、Johnson を含む [文字列] リストとして lastNameList を定義します。

名前のカンマ区切りリストなど、値の区切りリストが含まれる場合は、テキストからのリストを使用して値をリストに追加します。

値のリストの定義

値の定義に使用したのと同じ一連の手順を使用して、[単一の値] の代わりに [値のリスト] を選択して値のリストを作成できます。 各値を定義した後、それをリストに追加するか、値のリストを管理してアイテムを削除します。

1. [値のリスト] をクリックして、パラメーターの値のリストを定義します。
2. 選択したタイプの単一の値と同じ入力方法を使用します (ステップ 6 から開始)。 または、以下のテーブルにある各タイプの手順の概要をご参照ください。

   String	文字列を入力フィールドに入力します。
   番号	番号を入力フィールドに入力します 注意: Knowledge Studio は、-9007199254740991 (最小) から 9007199254740991 (最大) までの安全な整数のみをサポートします。 この範囲外の数値は、丸め処理のために不正確になってしまうため、ナレッジ グラフの Big Integer フィールドと一致しません。
   ジオメトリ	[ジオメトリの設定] をクリックすると、複数のジオメトリが描画されます
   Date Only	日付を MM/DD/YYYY 形式で入力するか、カレンダーを使用して日付を入力します。
   Time Only	HH:MM:SS.sss 形式で時間を入力するか、時間ピッカーを使用して時間を入力します
   Date	日付を HH:MM:SS.sss 形式で入力するか、カレンダーを使用して日付を入力します。 MM/DD/YYYY 形式で時間を入力するか、時間ピッカーを使用して時間を入力します
   Timestamp Offset	日付を HH:MM:SS.sss 形式で入力するか、カレンダーを使用して日付を入力します。 MM/DD/YYYY 形式で時間を入力するか、時間ピッカーを使用して時間を入力します。 UTC オフセットを分単位で入力します。
   エンティティ	入力フィールドを使用してエンティティを検索して選択します。
   リレーションシップ	入力フィールドを使用してリレーションシップを検索して選択します。

3. [追加] をクリックします
4. すべての値がリストに追加されるまで、ステップ 1 と 2 を繰り返します。
5. 必要に応じて、リストの値を管理します。
   • [値] 見出しをクリックして、リスト内の値を表示します。
   • 値をリストから削除するには、値の横にあるクリアをクリックします。
   • [クリア] をクリックし、リストを消去します。
   • [コピー] をクリックして、リスト内の値をシステムのクリップボードにコピーします。
6. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

テキストからのカスタム リスト

リストに追加する値が多数ある場合は、[テキストからのリスト] フィーチャを使用して値のリストを生成できます。 テキストからのリストは、名前のカンマ区切りリストなどの区切りリストを受け入れ、選択したタイプのパラメーターの値のリストを生成します (「サポートされるタイプ」のリストをご参照ください)。

1. [テキストからのリスト] をクリックします。

   [テキストからのリスト] モードが開きます。

2. リストの値を区切る文字を [区切り文字] 入力として入力します。 デフォルトはカンマです。 リストがタブまたは改行 (Enter) で区切られている場合は、適切なオプションをクリックします。
3. 区切られたリストをテキスト ボックスに貼り付けます。

   パラメーターのタイプがテキスト ボックスの上に表示されます。 リストのすべての値がこのタイプと一致する必要があります。

4. [リストの生成] をクリックします。

   [結果リスト] がテキスト ボックスの下に生成されます。

5. 必要に応じて、結果リストをクリックして結果を表示します
   1. 必要に応じて、値の横にある [X] をクリックして、値をリストから削除します。
6. 必要に応じて、[消去] をクリックして、すべての値をリストから消去します
7. [値をリストに追加] をクリックして、生成された値をパラメーター リストに追加します。
8. [適用] をクリックして、構成されたパラメーターを含む検索式を実行します。

検索式の結果は、新しいパラメーター値に基づいて更新されます。

パラメーターの削除

構成されたパラメーターはクエリから削除できます。

1. コンテキスト ツールバーで [パラメーター] をクリックします。

   [パラメーター] ウィンドウが開きます。

2. ウィンドウが開いて編集タブが表示されたら、[構成] タブをクリックします。
3. パラメーター名の横にあるオプション メニュー をクリックします。

   オプション メニューが開きます。

4. [削除] をクリックします。

   パラメーターが削除されます。

注意:

クエリにパラメーターがまだ含まれている場合、パラメーターがクエリから削除されるか再構成されていなければ、実行時にエラーが返されます。

値の編集

保存済みのクエリに対してパラメーターが構成されている場合、そのクエリを開くと、[パラメーター] ウィンドウが自動的に開き、[値の編集] タブが表示されます。

1. [パラメーター] ウィンドウが開いていない場合は、コンテキスト ツールバーの [パラメーター] をクリックします。

   パラメーター ウィンドウが開きます。 クエリに対して構成されたパラメーターがリストされます。

2. パラメーターの [タイプ] に基づいて値を更新します。

   各パラメーターのタイプは見出しの下に表示されます。 パラメーターで値のリストを使用する場合、[リスト] はタイプの後に含まれます。 リストの値を更新するには、値のリストの定義を参照してください。 クエリで使用される現在の値は、各パラメーターの入力エレメントに表示されます。 次に、各タイプの手順の概要を説明します。

   String	文字列を入力フィールドに入力します。
   番号	番号を入力フィールドに入力します 注意: Knowledge Studio は、-9007199254740991 (最小) から 9007199254740991 (最大) までの安全な整数のみをサポートします。 この範囲外の数値は、丸め処理のために不正確になってしまうため、ナレッジ グラフの Big Integer フィールドと一致しません。
   ジオメトリ	[ジオメトリの設定] をクリックすると、複数のジオメトリが描画されます
   Date Only	日付を MM/DD/YYYY 形式で入力するか、カレンダーを使用して日付を入力します。
   Time Only	HH:MM:SS.sss 形式で時間を入力するか、時間ピッカーを使用して時間を入力します
   Date	日付を HH:MM:SS.sss 形式で入力するか、カレンダーを使用して日付を入力します。 MM/DD/YYYY 形式で時間を入力するか、時間ピッカーを使用して時間を入力します
   Timestamp Offset	日付を HH:MM:SS.sss 形式で入力するか、カレンダーを使用して日付を入力します。 MM/DD/YYYY 形式で時間を入力するか、時間ピッカーを使用して時間を入力します。 UTC オフセットを分単位で入力します。
   エンティティ	入力フィールドを使用してエンティティを検索して選択します。
   リレーションシップ	入力フィールドを使用してリレーションシップを検索して選択します。

3. [適用] をクリックして、更新された値でクエリを実行します。

クエリの結果は、新しいパラメーター値に基づいて更新されます。