get_table

get_table(**kwargs)

Returns information about the table, including the table's name and current status, the keyspace name, configuration settings, and metadata.

To read table metadata using GetTable , Select action permissions for the table and system tables are required to complete the operation.

See also: AWS API Documentation

Request Syntax

response = client.get_table(
    keyspaceName='string',
    tableName='string'
)
Parameters
  • keyspaceName (string) --

    [REQUIRED]

    The name of the keyspace that the table is stored in.

  • tableName (string) --

    [REQUIRED]

    The name of the table.

Return type

dict

Returns

Response Syntax

{
    'keyspaceName': 'string',
    'tableName': 'string',
    'resourceArn': 'string',
    'creationTimestamp': datetime(2015, 1, 1),
    'status': 'ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'DELETED'|'RESTORING'|'INACCESSIBLE_ENCRYPTION_CREDENTIALS',
    'schemaDefinition': {
        'allColumns': [
            {
                'name': 'string',
                'type': 'string'
            },
        ],
        'partitionKeys': [
            {
                'name': 'string'
            },
        ],
        'clusteringKeys': [
            {
                'name': 'string',
                'orderBy': 'ASC'|'DESC'
            },
        ],
        'staticColumns': [
            {
                'name': 'string'
            },
        ]
    },
    'capacitySpecification': {
        'throughputMode': 'PAY_PER_REQUEST'|'PROVISIONED',
        'readCapacityUnits': 123,
        'writeCapacityUnits': 123,
        'lastUpdateToPayPerRequestTimestamp': datetime(2015, 1, 1)
    },
    'encryptionSpecification': {
        'type': 'CUSTOMER_MANAGED_KMS_KEY'|'AWS_OWNED_KMS_KEY',
        'kmsKeyIdentifier': 'string'
    },
    'pointInTimeRecovery': {
        'status': 'ENABLED'|'DISABLED',
        'earliestRestorableTimestamp': datetime(2015, 1, 1)
    },
    'ttl': {
        'status': 'ENABLED'
    },
    'defaultTimeToLive': 123,
    'comment': {
        'message': 'string'
    }
}

Response Structure

  • (dict) --

    • keyspaceName (string) --

      The name of the keyspace that the specified table is stored in.

    • tableName (string) --

      The name of the specified table.

    • resourceArn (string) --

      The Amazon Resource Name (ARN) of the specified table.

    • creationTimestamp (datetime) --

      The creation timestamp of the specified table.

    • status (string) --

      The current status of the specified table.

    • schemaDefinition (dict) --

      The schema definition of the specified table.

      • allColumns (list) --

        The regular columns of the table.

        • (dict) --

          The names and data types of regular columns.

          • name (string) --

            The name of the column.

          • type (string) --

            The data type of the column. For a list of available data types, see Data types in the Amazon Keyspaces Developer Guide .

      • partitionKeys (list) --

        The columns that are part of the partition key of the table .

        • (dict) --

          The partition key portion of the primary key is required and determines how Amazon Keyspaces stores the data. The partition key can be a single column, or it can be a compound value composed of two or more columns.

          • name (string) --

            The name(s) of the partition key column(s).

      • clusteringKeys (list) --

        The columns that are part of the clustering key of the table.

        • (dict) --

          The optional clustering column portion of your primary key determines how the data is clustered and sorted within each partition.

          • name (string) --

            The name(s) of the clustering column(s).

          • orderBy (string) --

            Sets the ascendant ( ASC ) or descendant ( DESC ) order modifier.

      • staticColumns (list) --

        The columns that have been defined as STATIC . Static columns store values that are shared by all rows in the same partition.

        • (dict) --

          The static columns of the table. Static columns store values that are shared by all rows in the same partition.

          • name (string) --

            The name of the static column.

    • capacitySpecification (dict) --

      The read/write throughput capacity mode for a table. The options are:

      • throughputMode:PAY_PER_REQUEST
      • throughputMode:PROVISIONED
      • throughputMode (string) --

        The read/write throughput capacity mode for a table. The options are:

        • throughputMode:PAY_PER_REQUEST and
        • throughputMode:PROVISIONED - Provisioned capacity mode requires readCapacityUnits and writeCapacityUnits as input.

        The default is throughput_mode:PAY_PER_REQUEST .

        For more information, see Read/write capacity modes in the Amazon Keyspaces Developer Guide .

      • readCapacityUnits (integer) --

        The throughput capacity specified for read operations defined in read capacity units (RCUs) .

      • writeCapacityUnits (integer) --

        The throughput capacity specified for write operations defined in write capacity units (WCUs) .

      • lastUpdateToPayPerRequestTimestamp (datetime) --

        The timestamp of the last operation that changed the provisioned throughput capacity of a table.

    • encryptionSpecification (dict) --

      The encryption settings of the specified table.

      • type (string) --

        The encryption option specified for the table. You can choose one of the following KMS keys (KMS keys):

        • type:AWS_OWNED_KMS_KEY - This key is owned by Amazon Keyspaces.
        • type:CUSTOMER_MANAGED_KMS_KEY - This key is stored in your account and is created, owned, and managed by you. This option requires the kms_key_identifier of the KMS key in Amazon Resource Name (ARN) format as input.

        The default is type:AWS_OWNED_KMS_KEY .

        For more information, see Encryption at rest in the Amazon Keyspaces Developer Guide .

      • kmsKeyIdentifier (string) --

        The Amazon Resource Name (ARN) of the customer managed KMS key, for example kms_key_identifier:ARN .

    • pointInTimeRecovery (dict) --

      The point-in-time recovery status of the specified table.

      • status (string) --

        Shows if point-in-time recovery is enabled or disabled for the specified table.

      • earliestRestorableTimestamp (datetime) --

        Specifies the earliest possible restore point of the table in ISO 8601 format.

    • ttl (dict) --

      The custom Time to Live settings of the specified table.

      • status (string) --

        Shows how to enable custom Time to Live (TTL) settings for the specified table.

    • defaultTimeToLive (integer) --

      The default Time to Live settings of the specified table.

    • comment (dict) --

      The the description of the specified table.

      • message (string) --

        An optional description of the table.

Exceptions

  • Keyspaces.Client.exceptions.ValidationException
  • Keyspaces.Client.exceptions.ServiceQuotaExceededException
  • Keyspaces.Client.exceptions.InternalServerException
  • Keyspaces.Client.exceptions.AccessDeniedException
  • Keyspaces.Client.exceptions.ResourceNotFoundException