CreateDataSet -

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CreateDataSet

Crea un conjunto de datos.

Sintaxis de la solicitud

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", "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" } ] } } ], "Source": { "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" }, "Tags": [ { "Key": "string", "Value": "string" } ] }

Parámetros de solicitud URI

La solicitud utiliza los siguientes parámetros URI.

AwsAccountId

El ID de la cuenta de AWS.

Restricciones de longitud: Longitud fija de 12.

Patrón: ^[0-9]{12}$

: obligatorio Sí

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

DataStid

ID del conjunto de datos que desea crear. Este ID es único por región de AWS para cada cuenta de AWS.

Tipo: Cadena

: obligatorio Sí

ImportMode

Indica si desea importar los datos a SPICE.

Tipo: Cadena

Valores válidos: SPICE | DIRECT_QUERY

: obligatorio Sí

Nombre

El nombre para mostrar para el conjunto de datos.

Tipo: Cadena

Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 128 caracteres.

: obligatorio Sí

PhysicalTableMap

Declara las tablas físicas que están disponibles en los orígenes de datos subyacentes.

Tipo: Cadena paraPhysicalTablemapa de objetos

Entradas de mapa: Número máximo de 32 elementos.

Restricciones de la clave: Longitud mínima de 1. La longitud máxima es 64.

Patrón clave:[0-9a-zA-Z-]*

: obligatorio Sí

ColumnGrupos

Agrupaciones de columnas que funcionan juntas en determinadas funciones de QuickSight. Actualmente, solo se admite la jerarquía geoespacial.

Tipo: Array deColumnGroupobjects

Miembros de matrices Número mínimo de 1 elemento. Número máximo de 8 elementos.

: obligatorio No

ColumnLevelPermissionRules

Un conjunto de una o varias definiciones de un ColumnLevelPermissionRule .

Tipo: Array deColumnLevelPermissionRuleobjects

Miembros de matrices Número mínimo de 1 elemento.

: obligatorio No

Carpetas de campo

La carpeta que contiene campos y subcarpetas anidadas para el conjunto de datos.

Tipo: Cadena paraFieldFoldermapa de objetos

Restricciones de la clave: Longitud mínima de 1. Longitud máxima: 1000 caracteres.

: obligatorio No

LogicalTableMap

Configura la combinación y transformación de los datos de las tablas físicas.

Tipo: Cadena paraLogicalTablemapa de objetos

Entradas de mapa: Número máximo de 64 elementos.

Restricciones de la clave: Longitud mínima de 1. La longitud máxima es 64.

Patrón clave:[0-9a-zA-Z-]*

: obligatorio No

Permisos

Una lista de permisos de recursos en el conjunto de datos.

Tipo: Array deResourcePermissionobjects

Miembros de matrices Número mínimo de 1 elemento. Número máximo de 64 elementos.

: obligatorio No

RowlevelPermissionDataset

La configuración de seguridad de nivel de fila para los datos que desea crear.

Tipo: objeto RowLevelPermissionDataSet

: obligatorio No

Etiquetas

Contiene un mapa de los pares clave-valor para la etiqueta o etiquetas de recurso asignadas al dataset.

Tipo: Array deTagobjects

Miembros de matrices Número mínimo de 1 elemento. Número máximo de 200 elementos.

: obligatorio No

Sintaxis de la respuesta

HTTP/1.1 Status Content-type: application/json { "Arn": "string", "DataSetId": "string", "IngestionArn": "string", "IngestionId": "string", "RequestId": "string" }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve la respuesta siguiente HTTP.

Estado

El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

Arn

El nombre de recurso de Amazon (ARN) del conjunto de datos.

Tipo: Cadena

DataStid

ID del conjunto de datos que desea crear. Este ID es único por región de AWS para cada cuenta de AWS.

Tipo: Cadena

Ingestionarn

El ARN para la ingestión, que se activa como resultado de la creación de conjuntos de datos si el modo de importación es SPICE.

Tipo: Cadena

IngestionID

El ID de la ingestión, que se activa como resultado de la creación de conjuntos de datos si el modo de importación es SPICE.

Tipo: Cadena

RequestId

ID de solicitud de AWS de esta operación.

Tipo: Cadena

Errors

Para obtener información sobre los errores que son comunes a todas las acciones, consulteErrores comunes.

AccessDeniedException

No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta tiene permiso para utilizar el servicio de Amazon QuickSight, que las políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.

Código de estado HTTP: 401

ConflictExcepción

La actualización o eliminación de un recurso puede provocar un estado incoherente.

Código de estado HTTP: 409

InternalFailureException

Se produjo un error interno.

Código de estado HTTP: 500

InvalidParameterValueException

Uno o más parámetros tienen un valor que no es válido.

Código de estado HTTP: 400

LimitExceededException

Se superó un límite.

Código de estado HTTP: 409

ResourceExistsException

El recurso especificado ya existe.

Código de estado HTTP: 409

ResourceNotFoundException

No se encontraron uno o varios recursos.

Código de estado HTTP: 404

ThrottlingException

El acceso está limitado.

Código de estado HTTP: 429

UnsupportedUserEditionException

Este error indica que está llamando a una operación en una suscripción de Amazon QuickSight en la que la edición no admite esa operación. Las ediciones actuales de Amazon QuickSight son Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones.

Código de estado HTTP: 403

Examples

Example

Este ejemplo ilustra un uso de CreateDataSet.

Solicitud de muestra

POST /accounts/{AwsAccountId}/data-sets HTTP/1.1 Content-type: application/json

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: