[ aws . lakeformation ]

update-table-objects

Description

Updates the manifest of Amazon S3 objects that make up the specified governed table.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  update-table-objects
[--catalog-id <value>]
--database-name <value>
--table-name <value>
[--transaction-id <value>]
--write-operations <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--catalog-id (string)

The catalog containing the governed table to update. Defaults to the caller’s account ID.

--database-name (string)

The database containing the governed table to update.

--table-name (string)

The governed table to update.

--transaction-id (string)

The transaction at which to do the write.

--write-operations (list)

A list of WriteOperation objects that define an object to add to or delete from the manifest for a governed table.

(structure)

Defines an object to add to or delete from a governed table.

AddObject -> (structure)

A new object to add to the governed table.

Uri -> (string)

The Amazon S3 location of the object.

ETag -> (string)

The Amazon S3 ETag of the object. Returned by GetTableObjects for validation and used to identify changes to the underlying data.

Size -> (long)

The size of the Amazon S3 object in bytes.

PartitionValues -> (list)

A list of partition values for the object. A value must be specified for each partition key associated with the table.

The supported data types are integer, long, date(yyyy-MM-dd), timestamp(yyyy-MM-dd HH:mm:ssXXX or yyyy-MM-dd HH:mm:ss”), string and decimal.

(string)

DeleteObject -> (structure)

An object to delete from the governed table.

Uri -> (string)

The Amazon S3 location of the object to delete.

ETag -> (string)

The Amazon S3 ETag of the object. Returned by GetTableObjects for validation and used to identify changes to the underlying data.

PartitionValues -> (list)

A list of partition values for the object. A value must be specified for each partition key associated with the governed table.

(string)

Shorthand Syntax:

AddObject={Uri=string,ETag=string,Size=long,PartitionValues=[string,string]},DeleteObject={Uri=string,ETag=string,PartitionValues=[string,string]} ...

JSON Syntax:

[
  {
    "AddObject": {
      "Uri": "string",
      "ETag": "string",
      "Size": long,
      "PartitionValues": ["string", ...]
    },
    "DeleteObject": {
      "Uri": "string",
      "ETag": "string",
      "PartitionValues": ["string", ...]
    }
  }
  ...
]

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

None