属性によるフィルター

属性によるフィルター ツールは、クエリーに基づいてデータセットのサブセットを返します。 クエリーで指定した条件を満たすレコードのみを含む新しいデータセットが出力されます。

例

属性によるフィルター ツールは次のようなシナリオで使用できます。

• ジオメトリーが含まれていないレコードをフィルターする場合。
• 特定の郵便番号を含むレコードのみを保持する場合。

パラメーター

次の表に、属性によるフィルター ツールで使用するパラメーターの概要を示します。

パラメーター	説明
入力データセット	フィルターするデータセット。
フィルター式	入力データセットのフィルターに使用する SQL クエリー。

使用上の注意

[入力データセット] パラメーターを使用して、フィルターするデータセットを特定します。

データセットをフィルターするには、[フィルター式] パラメーターを使用して、維持するレコードを特定する式を指定します。 式はブール値を返す必要があります。 式の条件を満たすレコードの場合、true が返され、そのレコードは結果に保持されます。 式の条件を満たさないレコードの場合、false が返され、そのレコードは結果から除外されます。

出力

ツール出力は、フィルター条件式で指定した条件を満たしたレコードのみを含むデータセットです。 出力データセットには、入力データセットのすべてのフィールドが含まれます。

制限事項

[属性によるフィルター] ツールの既知の制限事項は以下のとおりです。

• date または date only フィールドをフィルターする場合、次の式のタイプは協定世界時 (UTC) で処理されます。[今月]、[今年]、[以内]、[以内でない]。 その他すべての式のタイプは、ブラウザーのタイム ゾーンで処理されます。
• クエリーの構築に [式] または [グループ式] オプションを使用していて、文字列フィールドを選択した場合、プレビュー レコードのみに基づいた一意の値のリストが選択リストに表示されます。 これはソース データセット内の一意の値の完全なリストではありません。
• クエリーの構築に [SQL 式] オプションを使用している場合、次の制限が適用されます:
  • Boolean タイプのフィールドは使用できません。 Boolean フィールドをフィルターするには、[式] または [グループ式] オプションを使用します。
  • ジオメトリー タイプのフィールドは IS Null または IS NOT Null をフィルターするためにのみ使用できます。
• このツールは、指定した式と一致するレコードが含まれている単一のデータセットを返します。 指定した式を満たさないレコードは返されません。 除外されたレコードを含むデータセットを作成するには、同じ入力データセットと、最初に使用したのと逆のクエリーを使用してツールを再度実行します。

ライセンス要件

次のライセンスと構成が必要です。

• Creator または Professional ユーザー タイプ
• 公開者、ファシリテーター、管理者ロール、またはそれと同等のカスタム ロール

Data Pipelines の要件の詳細については、要件をご参照ください。