翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Quick でのパラメータのデフォルトの作成 このセクションを参照して、使用可能なパラメータのデフォルトのタイプと、それぞれのパラメータの設定方法の詳細について学びます。 各フィールドにパラメータとコントロールを関連付けることができます。ユーザーがダッシュボードまたは E メールレポートを表示すると、静的デフォルト値が設定されているシートコントロールでは、静的デフォルトが使われます。デフォルト値で、データのフィルタリング方法、カスタムアクションの動作、動的シートタイトルに表示されるテキストを変更できます。E メールレポートは、動的デフォルトもサポートしています。 最も簡単なデフォルトは、静的 (変化しない) デフォルトで、全員に同じ値が表示されます。ダッシュボードのデザイナーとして、デフォルト値を選択します。この値は、ダッシュボードを使用しているユーザーが変更することはできません。ただし、そのユーザーはコントロールから任意の値を選択できます。デフォルトを設定しても、これは変更されません。ユーザーが選択できる値を制限するには、行レベルのセキュリティの使用を検討します。詳細については、[データセットへのアクセスを制限するためのユーザーベースのルールでの行レベルのセキュリティの使用ユーザーベースのルールの使用](restrict-access-to-a-data-set-using-row-level-security.md)を参照してください。 **全員のダッシュボードビューに適用される静的デフォルト値を作成または編集するには** 1. 編集するパラメータでコンテキストメニュー (`v`) を選択するか、[Amazon Quick でのパラメータの設定](parameters-set-up.md) のステップに従って新しいパラメータを作成します。 1. 静的デフォルトを設定するには、[**Static default value (静的デフォルト値)**] の値を入力します。 ダッシュボードを表示しているユーザーに応じて異なるデフォルトを表示するには、動的デフォルトパラメータ (DDP) を作成します。動的デフォルトを使用するには、割り当てられたデフォルトにユーザーをマッピングする準備が必要です。まず、表示するユーザー、フィールド、デフォルト値に関する情報を含むデータベースクエリまたはデータファイルを作成する必要があります。これをデータセットに追加し、そのデータセットを分析に追加します。ここでは、情報の収集、データセットの作成、およびパラメータへの動的デフォルトの追加の手順について説明します。 動的デフォルト値のデータセットを作成する際は、次のガイドラインに従ってください。 + 単一のデータセットを使用して、ユーザーまたはグループの論理グループのすべての動的デフォルト定義を含めることをお勧めします。可能であれば、単一のテーブルまたはファイルにそれらを保持します。 + また、データセット内のフィールド名は、分析のフィールド名と一致させることを推奨します。例えば、複数のダッシュボードのデフォルトに同じデータセットを使用している場合、すべてのデータセットフィールドが分析の一部である必要はありません。フィールドは任意の順序で指定できます。 + 同じ列または同じデータセット内で、ユーザー名とグループ名の両方を組み合わせることはお勧めしません。このような設定にすると、メンテナンスとトラブルシューティングが煩雑になります。 + カンマ区切りファイルを使用してデータセットを作成する場合は、ファイル内の値の間のスペースを削除してください。次の例は、正しいカンマ区切り値の (CSV) 形式を示しています。英数字以外の文字 (スペース、アポストロフィなど) を含むテキスト (文字列) は、一重引用符または二重引用符で囲みます。日付または時刻のフィールドも引用符で囲むことができますが、必須ではありません。数値フィールドは引用符で囲むことができます (以下のように、数字に特殊文字が含まれている場合など)。 ``` "Value includes spaces","Field contains ' other characters",12345.6789,"20200808" ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08 ``` + データセットを作成したら、Quick がフィールドに対して選択するデータ型を再確認してください。 開始する前に、動的デフォルトを設定しようとしているユーザーのユーザー名またはグループ名のリストが必要です。ユーザーまたはグループのリストを生成するには、 AWS CLI を使用して情報を取得します。CLI コマンドを実行するには、 AWS CLI がインストールおよび設定されていることを確認します。詳細については、「*AWS CLI ユーザーガイド*」の「[Installing the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)」を参照してください。 これは、ユーザー名またはグループ名のリストを取得する方法の一例です。最適な方法を使用してください。 **動的デフォルトパラメータ (DDP) のユーザーを識別するには** + 個々のユーザー名またはグループ名のいずれかを一覧表示します。 + 個々のユーザー名を一覧表示するには、DDP のユーザーを識別する列を含めます。この列には、ID プロバイダーから Quick への接続に使用する各ユーザーのシステムユーザー名が含まれている必要があります。このユーザー名は多くの場合、@ 記号の前にあるユーザーの E メールエイリアスと同じです。 ユーザーのリストを取得するには、[ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html) Quick API オペレーションまたは AWS CLI コマンドを使用します。次の例に示すように、CLI コマンドを使用します。ID プロバイダーの AWS リージョン を指定します (例: `us-east-1`)。 ``` awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region ``` 次の例では、結果をアクティブなユーザーに限定するクエリを追加して、以前のコマンドを変更します。 ``` awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]' ``` 結果セットは以下の例のようになります。この例は、JSON 出力 (`--output json`) から抜粋したものです。フェデレーティッドユーザー名を持つユーザーは、`federated` という単語で始まるプリンシパル ID を持っています。 ``` [ { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva", "UserName": "anacarolinasilva", "Email": "anacasilva@example.com", "Role": "ADMIN", "Active": true, "PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate", "UserName": "Reader/liujie-stargate", "Role": "READER", "Active": true, "PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal", "UserName": "embedding/cxoportal", "Email": "saanvisarkar@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com", "UserName": "zhangwei@example.com", "Email": "zhangwei@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "user/d-96123-example-id-1123" } ] ``` + グループ名を一覧表示するには、DDP のユーザー名を含むグループを識別する列を含めます。この列には、ID プロバイダーから Quick への接続に使用されるシステムグループ名が含まれている必要があります。データセットに追加できるグループを特定するには、次の 1 つ以上のクイック API オペレーションまたは CLI コマンドを使用します。 + [ListGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroups.html) – ID プロバイダー AWS リージョン を含む の AWS アカウント ID と名前空間別にクイックグループを一覧表示します。 + [ListGroupMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroupMemberships.html) – 指定されたクイックグループのユーザーを一覧表示します。 + [ListUserGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUserGroups.html) – クイックユーザーがメンバーであるクイックグループを一覧表示します。 または、ID プロバイダーに問い合わせてこの情報を取得するよう、ネットワーク管理者に依頼することもできます。 次の 2 つの手順は、動的デフォルト値のデータセットの作成を完了する方法です。最初の手順は、単一値 DDP のデータセットを作成する方法です。2 番目は、複数値 DDP のデータセットを作成する方法です。 **単一値 DDP のデータセットを作成するには** 1. 単一値パラメータを持つデータセット列を作成します。クエリまたはファイルの最初の列は、ダッシュボードを使用しているユーザー用である必要があります。このフィールドには、ユーザー名またはグループ名を含めることができます。ただし、 グループのサポートは Quick Enterprise Edition でのみ利用できます。 1. 単一値パラメータの動的デフォルトを表示するフィールドごとに、データセットに列を追加します。列の名前は何でも構いません。フィールドまたはパラメータと同じ名前を使用できます。 単一値パラメータは、ユーザーエンティティと動的デフォルトの組み合わせがそのパラメータフィールドで一意である場合にのみ、指定どおりに機能します。ユーザーエンティティのデフォルトフィールドに複数の値がある場合、そのフィールドの単一値コントロールには、静的デフォルトが代わりに表示されます。静的デフォルトが定義されていない場合、コントロールにはデフォルト値が表示されません。一部のユーザー名は複数のグループのメンバーである可能性があるため、グループ名を使用する場合は注意が必要です。これらのグループのデフォルト値が異なる場合、このタイプのユーザー名は重複エントリとして機能します。 次の例は、2 つの単一値パラメータを含むテーブルを示しています。ユーザー名が複数のデフォルト値とペアになっていないため、この仮定を行います。このテーブルを理解しやすくするために、単語 `'default'` を分析のフィールド名の前に追加します。このように、以下のステートメントを作成し、各行の値を変更することで、テーブルを読み込むことができます。`anacarolinasilva` によって表示される場合、コントロールはデフォルトのリージョン `NorthEast` およびデフォルトのセグメント `SMB` を表示します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/parameters-default-values.html) 1. このデータを Quick にインポートし、新しいデータセットとして保存します。 1. 分析で、作成したデータセットを追加します。分析では、デフォルトで定義した列と一致する他のデータセットを 1 つ以上使用する必要があります。詳細については、「[分析へのデータセットの追加](adding-a-data-set-to-an-analysis.md)」 を参照してください。 **複数値 DDP のデータセットを作成するには** 1. 複数値パラメータを持つデータセット列を作成します。クエリまたはファイルの最初の列は、ダッシュボードを使用しているユーザー用である必要があります。このフィールドには、ユーザー名またはグループ名を含めることができます。ただし、 グループのサポートは Quick Enterprise Edition でのみ利用できます。 1. 複数値パラメータの動的デフォルトを表示するフィールドごとに、データセットに列を追加します。列の名前は何でも構いません。フィールドまたはパラメータと同じ名前を使用できます。 単一値パラメータとは異なり、複数値パラメータでは、パラメータに関連付けられたフィールドに複数の値を使用できます。 次の例は、単一値パラメータと複数値パラメータを含むテーブルを示しています。各ユーザー名は 1 つの列に一意の値を持ち、一部のユーザー名はもう一方の列に複数の値を持つため、この仮定を行うことができます。このテーブルを理解しやすくするために、単語 `'default'` を分析のフィールド名の前に追加します。このように、以下のステートメントを作成し、各列の値を変更することで、テーブルを読み込むことができます。`viewed-by` が `liujie` の場合、コントロールは `SouthEast` の `default-region` 値、および `Atlanta` の `default-city` 値を表示します。1 行先を読み込むと、`liujie` も `default-city` の `Raleigh` を表示します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/parameters-default-values.html) この例では、`default-region` を適用するパラメータは、単一値パラメータか複数値パラメータかにかかわらず、正しく機能します。単一値パラメータの場合、両方のエントリが同じ値 `SouthEast` であるため、1 人のユーザーに対して 2 つのエントリが機能します。複数値パラメータの場合も、デフォルトで 1 つの値のみが選択されている点を除いて、機能します。ただし、`default-city` を使用しているパラメータを変更した場合、デフォルトも複数値から単一値パラメータに変更されるため、これらのデフォルトは選択されません。代わりに、パラメータに静的デフォルトが定義されている場合は、静的デフォルトが使われます。例えば、`Atlanta` に静的デフォルトが設定されている場合、`liujie` はそのコントロールで `Raleigh` ではなく `Atlanta` を選択します。 場合によっては、静的デフォルト値が動的デフォルト値として使用されることもあります。その場合は、両方のデフォルト値を使用しないユーザー名のコントロールをテストしてください。 あるユーザー名が複数のグループに属している場合、指定されたユーザーには、2 つのグループのデフォルト値の和集合である一連のデフォルト値が表示されます。 1. このデータを Quick にインポートし、新しいデータセットとして保存します。 1. 分析で、作成したデータセットを追加します。分析では、デフォルトで定義した列と一致する他のデータセットを 1 つ以上使用する必要があります。詳細については、「[分析へのデータセットの追加](adding-a-data-set-to-an-analysis.md)」 を参照してください。 以下の手順に従って、分析に動的デフォルトパラメータを追加します。開始する前に、各ユーザー名またはグループ名の動的デフォルトを含むデータセットがあることを確認します。また、分析でこのデータセットを使用していることを確認してください。これらの要件については、前述の手順を参照してください。 **分析に DDP を追加するには** 1. クイックコンソールで、ページの上部にある**パラメータ**アイコンを選択し、既存のパラメータを選択します。パラメータのメニューから、**[Edit parameter]** (パラメータの編集) を選択します。新しいパラメータを追加するには、**[Parameters]** (パラメータ) の近くにあるプラス (`+`) 記号を選択します。 1. [**Set a dynamic default (動的なデフォルトを設定)**] を選択します。 1. 以下のオプションを設定します。 + **デフォルト値およびユーザー情報を含むデータセット** — 作成して分析に追加したデータセットを選択します。 + **ユーザー名の列** — ユーザー名に基づくデフォルトを作成するには、データセット内のユーザー名を含む列を選択します。 + **グループ名の列** — グループ名に基づくデフォルトを作成するには、データセット内のグループ名を含む列を選択します。 + **デフォルト値の列** — このパラメータのデフォルト値を含む列を選択します。 1. **[Apply]** (適用) を選択して設定変更を保存し、続いて **[Update]** (更新) を選択してパラメータの変更を保存します。変更せずに終了するには、**[Cancel]** (キャンセル) を選択します。 1. 動的デフォルトを含む各フィールドにフィルタを追加して、デフォルトを機能させます。パラメータによるフィルターの使用方法の詳細については、「[Amazon Quick のパラメータでフィルターを使用する](parameters-filtering-by.md)」を参照してください。 Amazon Quick は、ユーザー名がデータセットに存在しない、デフォルトが割り当てられていない、または一意のデフォルトを持たないすべてのユーザーに静的なデフォルト値を使用します。各ユーザーは、デフォルトのセットを 1 つだけ持つことができます。動的デフォルト値を使用しない場合は、静的デフォルトを設定できます。