翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateDataSet データセットを作成します。この操作は、アップロードされたファイルをソースとして含むデータセットをサポートしていません。 ## リクエストの構文 ``` POST /accounts/{{AwsAccountId}}/data-sets HTTP/1.1 Content-type: application/json { "ColumnGroups": [ { "GeoSpatialColumnGroup": { "Columns": [ "{{string}}" ], "CountryCode": "{{string}}", "Name": "{{string}}" } } ], "ColumnLevelPermissionRules": [ { "ColumnNames": [ "{{string}}" ], "Principals": [ "{{string}}" ] } ], "DataSetId": "{{string}}", "DataSetUsageConfiguration": { "DisableUseAsDirectQuerySource": {{boolean}}, "DisableUseAsImportedSource": {{boolean}} }, "FieldFolders": { "{{string}}" : { "columns": [ "{{string}}" ], "description": "{{string}}" } }, "ImportMode": "{{string}}", "LogicalTableMap": { "{{string}}" : { "Alias": "{{string}}", "DataTransforms": [ { "CastColumnTypeOperation": { "ColumnName": "{{string}}", "Format": "{{string}}", "NewColumnType": "{{string}}" }, "CreateColumnsOperation": { "Columns": [ { "ColumnId": "{{string}}", "ColumnName": "{{string}}", "Expression": "{{string}}" } ] }, "FilterOperation": { "ConditionExpression": "{{string}}" }, "ProjectOperation": { "ProjectedColumns": [ "{{string}}" ] }, "RenameColumnOperation": { "ColumnName": "{{string}}", "NewColumnName": "{{string}}" }, "TagColumnOperation": { "ColumnName": "{{string}}", "Tags": [ { "ColumnDescription": { "Text": "{{string}}" }, "ColumnGeographicRole": "{{string}}" } ] }, "UntagColumnOperation": { "ColumnName": "{{string}}", "TagNames": [ "{{string}}" ] } } ], "Source": { "DataSetArn": "{{string}}", "JoinInstruction": { "LeftJoinKeyProperties": { "UniqueKey": {{boolean}} }, "LeftOperand": "{{string}}", "OnClause": "{{string}}", "RightJoinKeyProperties": { "UniqueKey": {{boolean}} }, "RightOperand": "{{string}}", "Type": "{{string}}" }, "PhysicalTableId": "{{string}}" } } }, "Name": "{{string}}", "Permissions": [ { "Actions": [ "{{string}}" ], "Principal": "{{string}}" } ], "PhysicalTableMap": { "{{string}}" : { "CustomSql": { "Columns": [ { "Name": "{{string}}", "Type": "{{string}}" } ], "DataSourceArn": "{{string}}", "Name": "{{string}}", "SqlQuery": "{{string}}" }, "RelationalTable": { "Catalog": "{{string}}", "DataSourceArn": "{{string}}", "InputColumns": [ { "Name": "{{string}}", "Type": "{{string}}" } ], "Name": "{{string}}", "Schema": "{{string}}" }, "S3Source": { "DataSourceArn": "{{string}}", "InputColumns": [ { "Name": "{{string}}", "Type": "{{string}}" } ], "UploadSettings": { "ContainsHeader": {{boolean}}, "Delimiter": "{{string}}", "Format": "{{string}}", "StartFromRow": {{number}}, "TextQualifier": "{{string}}" } } } }, "RowLevelPermissionDataSet": { "Arn": "{{string}}", "FormatVersion": "{{string}}", "Namespace": "{{string}}", "PermissionPolicy": "{{string}}", "Status": "{{string}}" }, "RowLevelPermissionTagConfiguration": { "Status": "{{string}}", "TagRules": [ { "ColumnName": "{{string}}", "MatchAllValue": "{{string}}", "TagKey": "{{string}}", "TagMultiValueDelimiter": "{{string}}" } ] }, "Tags": [ { "Key": "{{string}}", "Value": "{{string}}" } ] } ``` ## URI リクエストパラメータ リクエストでは、次の URI パラメータを使用します。 ** [AwsAccountId](#API_CreateDataSet_RequestSyntax) ** AWS アカウント ID。 長さの制約: 固定長は 12 です。 パターン: `^[0-9]{12}$` 必須: はい ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [DataSetId](#API_CreateDataSet_RequestSyntax) ** 作成するデータセットの ID。この ID は、各 AWS アカウントの AWS リージョン ごとに一意です。 Type: 文字列 必須: はい ** [ImportMode](#API_CreateDataSet_RequestSyntax) ** データを SPICE にインポートするかどうかを示す。 Type: 文字列 有効な値: ` SPICE | DIRECT_QUERY` 必須: はい ** [Name](#API_CreateDataSet_RequestSyntax) ** データセットの表示名。 Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 128 です。 必須: はい ** [PhysicalTableMap](#API_CreateDataSet_RequestSyntax) ** 基になるデータソースで使用可能な物理テーブルを宣言します。 Type: 文字列[PhysicalTable](API_PhysicalTable.md)オブジェクトマップ マップエントリ: 最小項目数は 0 です。最大数は 32 項目です。 キーの長さの制約: 最小長は 1 です｡ 最大長は 64 文字です。 キーパターン: `[0-9a-zA-Z-]*` 必須: はい ** [ColumnGroups](#API_CreateDataSet_RequestSyntax) ** 特定の Amazon で連携して機能する列のグループ QuickSight します。。。現在、地理空間階層のみがサポートされています。 Type: 配列[ColumnGroup](API_ColumnGroup.md)オブジェクト 配列メンバー: 最小数は 1 項目です。最大数は 8 項目です。 必須: いいえ ** [ColumnLevelPermissionRules](#API_CreateDataSet_RequestSyntax) ** ` [ColumnLevelPermissionRule](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ColumnLevelPermissionRule.html) ` の 1 つ以上の定義セット。 Type: 配列[ColumnLevelPermissionRule](API_ColumnLevelPermissionRule.md)オブジェクト 配列メンバー: 最小数は 1 項目です。 必須: いいえ ** [DataSetUsageConfiguration](#API_CreateDataSet_RequestSyntax) ** このデータセットをソースとして参照する子データセットに適用する使用構成。 型: [DataSetUsageConfiguration](API_DataSetUsageConfiguration.md) オブジェクト 必須: いいえ ** [FieldFolders](#API_CreateDataSet_RequestSyntax) ** データセットのフィールドとネストされたサブフォルダを含むフォルダ。 Type: 文字列[FieldFolder](API_FieldFolder.md)オブジェクトマップ キーの長さの制約: 最小長は 1 です｡ 最大長は 1,000 です。 必須: いいえ ** [LogicalTableMap](#API_CreateDataSet_RequestSyntax) ** 物理テーブルからのデータの組み合わせと変換を設定します。 Type: 文字列[LogicalTable](API_LogicalTable.md)オブジェクトマップ マップエントリ: 最大数は 64 項目です。 キーの長さの制約: 最小長は 1 です｡ 最大長は 64 文字です。 キーパターン: `[0-9a-zA-Z-]*` 必須: いいえ ** [Permissions](#API_CreateDataSet_RequestSyntax) ** データセットに対するリソースのアクセス許可のリスト。 Type: 配列[ResourcePermission](API_ResourcePermission.md)オブジェクト 配列メンバー: 最小数は 1 項目です。最大数は 64 項目です。 必須: いいえ ** [RowLevelPermissionDataSet](#API_CreateDataSet_RequestSyntax) ** 作成するデータに対する行レベルのセキュリティ設定。 型: [RowLevelPermissionDataSet](API_RowLevelPermissionDataSet.md) オブジェクト 必須: いいえ ** [RowLevelPermissionTagConfiguration](#API_CreateDataSet_RequestSyntax) ** 行レベルのセキュリティを設定するためのデータセット上のタグの構成。行レベルのセキュリティタグは、現在、匿名埋め込みでのみサポートされています。 型: [RowLevelPermissionTagConfiguration](API_RowLevelPermissionTagConfiguration.md) オブジェクト 必須: いいえ ** [Tags](#API_CreateDataSet_RequestSyntax) ** データセットに割り当てられたリソースタグのキーと値のペアのマップが含まれます。 Type: 配列[Tag](API_Tag.md)オブジェクト 配列メンバー: 最小数は 1 項目です。最大 200 項目。 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 {{Status}} Content-type: application/json { "Arn": "string", "DataSetId": "string", "IngestionArn": "string", "IngestionId": "string", "RequestId": "string" } ``` ## レスポンス要素 アクションが成功すると、以下の HTTP レスポンスが返されます。 ** [Status](#API_CreateDataSet_ResponseSyntax) ** リクエストの HTTP ステータス。 サービスから以下のデータが JSON 形式で返されます。 ** [Arn](#API_CreateDataSet_ResponseSyntax) ** データセットの Amazon リソースネーム (ARN)。 Type: 文字列 ** [DataSetId](#API_CreateDataSet_ResponseSyntax) ** 作成するデータセットの ID。この ID は、各 AWS アカウントの AWS リージョン ごとに一意です。 Type: 文字列 ** [IngestionArn](#API_CreateDataSet_ResponseSyntax) ** インポートモードが SPICE の場合、データセット作成の結果としてトリガーされる取り込みの ARN。 Type: 文字列 ** [IngestionId](#API_CreateDataSet_ResponseSyntax) ** インポートモードが SPICE の場合、データセット作成の結果としてトリガーされる取り込みの ID。 Type: 文字列 ** [RequestId](#API_CreateDataSet_ResponseSyntax) ** -AWSこの処理のリクエストID。 Type: 文字列 ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** この項目にはアクセスできません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。アカウントがAmazonの使用を許可されていることを確認してください QuickSight ポリシーに正しいアクセス許可があること、正しいアクセスキーを使っていることを確認してください。 HTTP ステータスコード: 401 ** ConflictException ** リソースを更新または削除すると、一貫性のない状態が発生する可能性があります。 HTTP ステータスコード: 409 ** InternalFailureException ** 内部エラーが発生しました。 HTTP ステータスコード: 500 ** InvalidParameterValueException ** 1 つ以上のパラメータに無効な値があります。 HTTP ステータスコード: 400 ** LimitExceededException ** 制限を超過しています。 HTTP ステータスコード: 409 ** ResourceExistsException ** 指定されたリソースは既に存在します。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** 1 つ以上のリソースが見つかりません。 HTTP ステータスコード: 404 ** ThrottlingException ** アクセスが調整済みです。 HTTP ステータスコード: 429 ** UnsupportedUserEditionException ** このエラーは、Amazonでオペレーションを呼び出していることを示します。 QuickSightエディションにその操作のサポートが含まれていないサブスクリプション。アマゾンアマゾン QuickSight 現在、Standard Edition があります。すべてのオペレーションと機能がすべてのエディションで利用できるわけではありません。​ HTTP ステータスコード: 403 ## 例 ### 例 この例で示すのは、以下の機能の使用方法の CreateDataSet。 #### リクエスト例 ``` POST /accounts/{AwsAccountId}/data-sets HTTP/1.1 Content-type: application/json ``` ## 以下の資料も参照してください。 言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateDataSet) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateDataSet) + [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateDataSet) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateDataSet) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateDataSet) + [AWS向け SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateDataSet) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateDataSet) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateDataSet) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateDataSet)