翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
データアクションは、すべてのレコードの取得や ID によるレコードの取得など、エンティティのデータに対してアクションを実行するためにアプリケーションで使用されます。データアクションを使用して、テーブルや詳細ビューなどのコンポーネントに表示される、指定された条件に一致するデータを検索して返すことができます。
データアクションの作成
ヒント
CTRL+Z キーを押して、エンティティに対する最新の変更を元に戻すことができます。
必要に応じて、データアクションを作成するエンティティに移動します。
データアクションタブを選択します。
データアクションを作成するには、次の 2 つの方法があります。
（推奨) AI を使用して、エンティティ名、フィールド、接続されたデータソースに基づいてデータアクションを生成するには、データアクションの生成を選択します。次のアクションが生成されます。
getAll: エンティティからすべてのレコードを取得します。このアクションは、レコードのリストを表示したり、複数のレコードに対して一度にオペレーションを実行したりする必要がある場合に便利です。getByID: 一意の識別子 (ID またはプライマリキー) に基づいてエンティティから 1 つのレコードを取得します。このアクションは、特定のレコードに対してオペレーションを表示または実行する必要がある場合に便利です。
1 つのデータアクションを追加するには、 + データアクションの追加を選択します。
新しいデータアクションを表示または設定するには、次のセクション「」を参照してくださいデータアクションの編集または設定。
データアクションの編集または設定
必要に応じて、データアクションを作成するエンティティに移動します。
データアクションタブを選択します。
フィールドで、クエリによって返されるフィールドを設定します。デフォルトでは、エンティティの設定済みフィールドがすべて選択されます。
次のステップを実行して、データアクションに Joins を追加することもできます。
+ 結合を追加 を選択してダイアログボックスを開きます。
関連エンティティで、現在のエンティティと結合するエンティティを選択します。
エイリアスで、必要に応じて、関連するエンティティの一時的なエイリアス名を入力します。
結合タイプで、目的の結合タイプを選択します。
各エンティティからフィールドを選択して結合句を定義します。
追加 を選択して結合を作成します。
作成されると、結合セクションに結合が表示され、フィールドから戻り値へのドロップダウンで追加のフィールドを使用できます。複数の結合を追加できます。これには、エンティティ間の連鎖結合も含まれます。結合されたエンティティのフィールドでフィルタリングおよびソートすることもできます。
結合を削除するには、結合の横にあるごみ箱アイコンを選択します。これにより、それらのフィールドを使用して、その結合からすべてのフィールドが削除され、依存結合または制約が破棄されます。
条件で、クエリの出力をフィルタリングするルールを追加、編集、または削除します。ルールをグループに整理し、複数のルールを
ANDまたはORステートメントと連鎖させることができます。使用できる演算子の詳細については、「」を参照してくださいデータアクション条件演算子と例。ソートで、属性を選択し、昇順または降順を選択して、クエリ結果のソート方法を設定します。ソートルールの横にあるごみ箱アイコンを選択して、ソート設定を削除できます。
変換結果では、カスタム JavaScript を入力して、結果を表示またはオートメーションに送信する前に結果を変更またはフォーマットできます。
出力プレビューで、設定されたフィールド、フィルター、ソート、JavaScript に基づいてクエリ出力のプレビューテーブルを表示します JavaScript 。
データアクション条件演算子と例
条件演算子を使用して、設定された式値をエンティティ列と比較し、データベースオブジェクトのサブセットを返すことができます。使用できる演算子は、列のデータ型と、Amazon Redshift、Amazon Aurora、Amazon DynamoDB など、エンティティが接続されているデータベースのタイプによって異なります。
次の条件演算子は、すべてのデータベースサービスで使用できます。
=および!=: すべてのデータ型 (プライマリキー列を除く) で使用できます。<=、>=、<、および>=: 数値列でのみ使用できます。IS NULLおよびIS NOT NULL: null または空の値を持つ列を一致させるために使用されます。Null 値は、データベースごとに解釈が異なることがよくありますが、App Studio では、NULLオペレータは接続されたデータベーステーブルに Null 値を持つレコードを照合して返します。
次の条件演算子は、それらをサポートするデータベースサービスに接続されているエンティティでのみ使用できます。
LIKEおよびNOT LIKE(Redshift、Aurora): 接続されたデータベースでパターンベースのクエリを実行するために使用されます。LIKE演算子は、指定されたパターンに適合するレコードを検索して返すため、検索機能の柔軟性を提供します。パターンは、パターン内の任意の文字または文字のシーケンスに一致するワイルドカード文字を使用して定義します。各データベース管理システムには一意のワイルドカード文字のセットがありますが、最も人気のある 2 つは任意の数の文字 (0 を含む)%を表し_、1 つの文字を表すことです。ContainsおよびNot Contains(DynamoDB): 大文字と小文字を区別する検索を実行して、指定されたテキストが列値内で見つかったかどうかを判断するために使用されます。Starts WithおよびNot Starts With(DynamoDB): 大文字と小文字を区別する検索を実行して、指定されたテキストが列値の先頭で見つかったかどうかを判断するために使用されます。
データベースによる条件演算子のサポート
次の表は、App Studio に接続できる各データベースでサポートされているデータアクション条件演算子を示しています。
| =, !=, <, >, <=, >= | LIKE、NOT LIKE | 含まれる、含まれない | で始まるが で始まらない | IS NULL、IS NOT NULL | |
|---|---|---|---|---|---|
|
DynamoDB |
はい |
なし |
はい |
あり |
はい |
|
Aurora |
はい |
はい |
いいえ |
いいえ |
はい |
|
Redshift |
はい |
はい |
いいえ |
いいえ |
はい |
データアクション条件の例
、、namecityおよび hireDateフィールドを持つ複数の項目を含む次のデータベーステーブルを検討してください。
| 名前 | city | hireDate |
|---|---|---|
|
アダム |
Seattle |
2025-03-01 |
|
アドリアン語 |
ボストン |
2025-03-05 |
|
Bob |
アルバカーキ |
2025-03-06 |
|
Carlos |
シカゴ |
2025-03-10 |
|
キャロライン |
NULL |
2025-03-12 |
|
リタ |
マイアミ |
2025-03-15 |
ここで、指定された条件に一致する項目の nameフィールドを返すデータアクションを App Studio で作成することを検討してください。次のリストには、条件の例と、テーブルがそれぞれに対して返す値が含まれています。
注記
例は SQL の例としてフォーマットされています。App Studio では表示されない場合がありますが、演算子の動作を示すために使用されます。
WHERE name LIKE 'Adam': を返しますAdam。WHERE name LIKE 'A%':Adamと を返しますAdrienne。WHERE name NOT LIKE 'B_B':Adam、Adrienne、Carlos、Caroline、および を返しますRita。WHERE contains(name, 'ita'): を返しますRita。WHERE begins_with(name, 'Car'):Carlosと を返しますCaroline。WHERE city IS NULL: を返しますCaroline。WHERE hireDate < "2025-03-06":Adamと を返しますAdrienne。WHERE hireDate >= DateTime.now().toISODate(): は現在の日付DateTime.now().toISODate()を返します。現在の日付が 2025-03-10 のシナリオでは、式はCarlos、Caroline、および を返しますRita。
ヒント
式での日付と時刻の比較の詳細については、「」を参照してください日付および時間。
データアクションの削除
App Studio エンティティからデータアクションを削除するには、次の手順に従います。
必要に応じて、データアクションを削除するエンティティに移動します。
データアクションタブを選択します。
削除するデータアクションごとに、編集の横にあるドロップダウンメニューを選択し、削除を選択します。
ダイアログボックスで確認 を選択します。
