As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
UpdateDataSet
Atualiza um conjunto de dados. Essa operação não oferece suporte a conjuntos de dados que incluem arquivos carregados como fonte.
Sintaxe da solicitação
PUT /accounts/AwsAccountId/data-sets/DataSetId HTTP/1.1
Content-type: application/json
{
"ColumnGroups": [
{
"GeoSpatialColumnGroup": {
"Columns": [ "string" ],
"CountryCode": "string",
"Name": "string"
}
}
],
"ColumnLevelPermissionRules": [
{
"ColumnNames": [ "string" ],
"Principals": [ "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",
"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"
}
]
}
}Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AwsAccountId
-
O ID da conta da AWS.
Restrições de comprimento: Tamanho fixo de 12.
Padrão:
^[0-9]{12}$Obrigatório: Sim
- DataSetId
-
O ID do conjunto de dados que você deseja atualizar. Esse ID é único porRegião da AWSpara cadaAWSconta.
Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- ImportMode
-
Indica se você deseja importar os dados para o SPICE.
Type: String
Valores válidos:
SPICE | DIRECT_QUERYObrigatório: Sim
- Name
-
O nome de exibição do conjunto de dados.
Type: String
Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 128.
Obrigatório: Sim
- PhysicalTableMap
-
Declara as tabelas físicas que estão disponíveis nas fontes de dados subjacentes.
Type: String paraPhysicalTablemapa de objetos
Entradas no mapa: Número máximo de 0 itens. Número máximo de 32 itens.
Restrições de tamanho da chave: Tamanho mínimo de 1. Tamanho máximo de 64.
Padrão da chave:
[0-9a-zA-Z-]*Obrigatório: Sim
- ColumnGroups
-
Agrupamentos de colunas que funcionam juntas em determinadas Amazon QuickSight Recursos do. Atualmente, apenas a hierarquia geoespacial é suportada.
Type: String ArrayColumnGroupobjetos
Membros da matriz: Número mínimo de 1 item. Número máximo de 8 itens.
Obrigatório: Não
- ColumnLevelPermissionRules
-
Um conjunto de uma ou mais definições de uma
ColumnLevelPermissionRule.Type: String ArrayColumnLevelPermissionRuleobjetos
Membros da matriz: Número mínimo de 1 item.
Obrigatório: Não
- DataSetUsageConfiguration
-
A configuração de uso a ser aplicada a conjuntos de dados filhos que fazem referência a esse conjunto de dados como uma fonte.
Tipo: objeto DataSetUsageConfiguration
Obrigatório: Não
- FieldFolders
-
A pasta que contém campos e subpastas aninhadas para o conjunto de dados.
Type: String paraFieldFoldermapa de objetos
Restrições de tamanho da chave: Tamanho mínimo de 1. Tamanho máximo de 1000.
Obrigatório: Não
- LogicalTableMap
-
Configura a combinação e transformação dos dados das tabelas físicas.
Type: String paraLogicalTablemapa de objetos
Entradas no mapa: Número máximo de 64 itens.
Restrições de tamanho da chave: Tamanho mínimo de 1. Tamanho máximo de 64.
Padrão da chave:
[0-9a-zA-Z-]*Obrigatório: Não
- RowLevelPermissionDataSet
-
A configuração de segurança no nível da linha para os dados que você deseja criar.
Tipo: objeto RowLevelPermissionDataSet
Obrigatório: Não
- RowLevelPermissionTagConfiguration
-
A configuração de tags em um conjunto de dados para definir a segurança no nível da linha. No momento, as tags de segurança no nível da linha são suportadas apenas para incorporação anônima.
Tipo: objeto RowLevelPermissionTagConfiguration
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"DataSetId": "string",
"IngestionArn": "string",
"IngestionId": "string",
"RequestId": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
- Status
-
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
- Arn
-
O nome de recurso da Amazon (ARN) do conjunto de dados.
Type: String
- DataSetId
-
O ID do conjunto de dados que você deseja criar. Esse ID é único porRegião da AWSpara cadaAWSconta.
Type: String
- IngestionArn
-
O ARN para a ingestão, que é acionado como resultado da criação do conjunto de dados se o modo de importação for SPICE.
Type: String
- IngestionId
-
O ID da ingestão, que é acionado como resultado da criação do conjunto de dados se o modo de importação for SPICE.
Type: String
- RequestId
-
OAWSID da solicitação para essa operação.
Type: String
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulteErros comuns.
- AccessDeniedException
-
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.
Código de status HTTP: 401
- ConflictException
-
Atualizar ou excluir um recurso pode causar um estado inconsistente.
Código de status HTTP: 409
- InternalFailureException
-
Ocorreu um erro interno.
Código de status HTTP: 500
- InvalidParameterValueException
-
Um ou mais parâmetros têm um valor que não é válido.
Código de status HTTP: 400
- LimitExceededException
-
Um limite foi excedido.
Código de status HTTP: 409
- ResourceNotFoundException
-
Não foi possível encontrar um ou mais recursos.
Código de status HTTP: 404
- ThrottlingException
-
O acesso é limitado.
Código de status HTTP: 429
- UnsupportedUserEditionException
-
Esse erro indica que você está chamando uma operação em uma Amazon QuickSightassinatura em que a edição não inclui suporte para essa operação. Amazon Amazon QuickSight No momento, a Standard Edition e Enterprise Edition. Nem todas operações e recursos estão disponível em todas as edições.
Código de status HTTP: 403
Exemplos
Exemplo
Este exemplo ilustra um uso de UpdateDataSet.
Exemplo de solicitação
POST /accounts/{AwsAccountId}/data-sets/{DataSetId} HTTP/1.1
Content-type: application/jsonConsulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
