Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# DescribeDataSet
Décrit un ensemble de données. Cette opération ne prend pas en charge les jeux de données qui incluent des fichiers téléchargés en tant que source.
## Syntaxe de la demande
```
GET /accounts/AwsAccountId/data-sets/DataSetId HTTP/1.1
```
## Paramètres de demande URI
La demande utilise les paramètres URI suivants.
** [AwsAccountId](#API_DescribeDataSet_RequestSyntax) **
L'ID de compte AWS.
Contraintes de longueur : Longueur fixe de 12.
Modèle : `^[0-9]{12}$`
Obligatoire : Oui
** [DataSetId](#API_DescribeDataSet_RequestSyntax) **
ID du ensemble de données que vous souhaitez créer. Cet ID est unique parRégion AWSpour chaqueAWS.
Obligatoire : Oui
## Corps de la requête
La demande n'a pas de corps de requête.
## Syntaxe de la réponse
```
HTTP/1.1 Status
Content-type: application/json
{
"DataSet": {
"Arn": "string",
"ColumnGroups": [
{
"GeoSpatialColumnGroup": {
"Columns": [ "string" ],
"CountryCode": "string",
"Name": "string"
}
}
],
"ColumnLevelPermissionRules": [
{
"ColumnNames": [ "string" ],
"Principals": [ "string" ]
}
],
"ConsumedSpiceCapacityInBytes": number,
"CreatedTime": number,
"DataSetId": "string",
"DataSetUsageConfiguration": {
"DisableUseAsDirectQuerySource": boolean,
"DisableUseAsImportedSource": boolean
},
"FieldFolders": {
"string" : {
"columns": [ "string" ],
"description": "string"
}
},
"ImportMode": "string",
"LastUpdatedTime": number,
"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",
"OutputColumns": [
{
"Description": "string",
"Name": "string",
"Type": "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"
}
]
}
},
"RequestId": "string"
}
```
## Eléments de réponse
Si l'action aboutit, le service renvoie la réponse HTTP suivante.
** [Status](#API_DescribeDataSet_ResponseSyntax) **
Le statut HTTP de la requête.
Les données suivantes sont renvoyées au format JSON par le service.
** [DataSet](#API_DescribeDataSet_ResponseSyntax) **
Informations sur l'ensemble de données.
Type : objet [DataSet](API_DataSet.md)
** [RequestId](#API_DescribeDataSet_ResponseSyntax) **
LeAWSID de demande pour cette opération.
Type : Chaîne
## Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).
** AccessDeniedException **
Vous n'avez pas accès à cet article. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès.
Code d'état HTTP : 401
** InternalFailureException **
Une défaillance interne s'est produite.
Code d'état HTTP : 500
** InvalidParameterValueException **
La valeur d'un ou de plusieurs paramètres n'est pas valide.
Code d'état HTTP : 400
** ResourceNotFoundException **
Une ou plusieurs ressources n'ont pas pu être trouvées.
Code d'état HTTP : 404
** ThrottlingException **
L'accès est limité.
Code d'état HTTP : 429
## Exemples
### Exemple
Cet exemple illustre une utilisation de DescribeDataSet.
#### Exemple de demande
```
GET /accounts/{AwsAccountId}/data-sets/{DataSetId} HTTP/1.1
Content-type: application/json
```
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+ [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/DescribeDataSet)
+ [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/DescribeDataSet)
+ [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/DescribeDataSet)
+ [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/DescribeDataSet)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/DescribeDataSet)
+ [AWSKits SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/DescribeDataSet)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/DescribeDataSet)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/DescribeDataSet)
+ [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/DescribeDataSet)