KeyspacesStreams / Client / get_records
get_records¶
- KeyspacesStreams.Client.get_records(**kwargs)¶
Retrieves data records from a specified shard in an Amazon Keyspaces data stream. This operation returns a collection of data records from the shard, including the primary key columns and information about modifications made to the captured table data. Each record represents a single data modification in the Amazon Keyspaces table and includes metadata about when the change occurred.
See also: AWS API Documentation
Request Syntax
response = client.get_records( shardIterator='string', maxResults=123 )
- Parameters:
shardIterator (string) –
[REQUIRED]
The unique identifier of the shard iterator. A shard iterator specifies the position in the shard from which you want to start reading data records sequentially. You obtain this value by calling the
GetShardIterator
operation. Each shard iterator is valid for 5 minutes after creation.maxResults (integer) – The maximum number of records to return in a single
GetRecords
request. Default value is 1000. You can specify a limit between 1 and 10000, but the actual number returned might be less than the specified maximum if the size of the data for the returned records exceeds the internal size limit.
- Return type:
dict
- Returns:
Response Syntax
{ 'changeRecords': [ { 'eventVersion': 'string', 'createdAt': datetime(2015, 1, 1), 'origin': 'USER'|'REPLICATION'|'TTL', 'partitionKeys': { 'string': { 'asciiT': 'string', 'bigintT': 'string', 'blobT': b'bytes', 'boolT': True|False, 'counterT': 'string', 'dateT': 'string', 'decimalT': 'string', 'doubleT': 'string', 'floatT': 'string', 'inetT': 'string', 'intT': 'string', 'listT': [ { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'mapT': [ { 'key': {'... recursive ...'}, 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'setT': [ { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'smallintT': 'string', 'textT': 'string', 'timeT': 'string', 'timestampT': 'string', 'timeuuidT': 'string', 'tinyintT': 'string', 'tupleT': [ { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'uuidT': 'string', 'varcharT': 'string', 'varintT': 'string', 'udtT': { 'string': { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } } } } }, 'clusteringKeys': { 'string': { 'asciiT': 'string', 'bigintT': 'string', 'blobT': b'bytes', 'boolT': True|False, 'counterT': 'string', 'dateT': 'string', 'decimalT': 'string', 'doubleT': 'string', 'floatT': 'string', 'inetT': 'string', 'intT': 'string', 'listT': [ { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'mapT': [ { 'key': {'... recursive ...'}, 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'setT': [ { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'smallintT': 'string', 'textT': 'string', 'timeT': 'string', 'timestampT': 'string', 'timeuuidT': 'string', 'tinyintT': 'string', 'tupleT': [ { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'uuidT': 'string', 'varcharT': 'string', 'varintT': 'string', 'udtT': { 'string': { 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } } } } }, 'newImage': { 'valueCells': { 'string': { 'value': { 'asciiT': 'string', 'bigintT': 'string', 'blobT': b'bytes', 'boolT': True|False, 'counterT': 'string', 'dateT': 'string', 'decimalT': 'string', 'doubleT': 'string', 'floatT': 'string', 'inetT': 'string', 'intT': 'string', 'listT': [ {'... recursive ...'}, ], 'mapT': [ { 'key': {'... recursive ...'}, 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'setT': [ {'... recursive ...'}, ], 'smallintT': 'string', 'textT': 'string', 'timeT': 'string', 'timestampT': 'string', 'timeuuidT': 'string', 'tinyintT': 'string', 'tupleT': [ {'... recursive ...'}, ], 'uuidT': 'string', 'varcharT': 'string', 'varintT': 'string', 'udtT': { 'string': {'... recursive ...'} } }, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } } }, 'staticCells': { 'string': { 'value': { 'asciiT': 'string', 'bigintT': 'string', 'blobT': b'bytes', 'boolT': True|False, 'counterT': 'string', 'dateT': 'string', 'decimalT': 'string', 'doubleT': 'string', 'floatT': 'string', 'inetT': 'string', 'intT': 'string', 'listT': [ {'... recursive ...'}, ], 'mapT': [ { 'key': {'... recursive ...'}, 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'setT': [ {'... recursive ...'}, ], 'smallintT': 'string', 'textT': 'string', 'timeT': 'string', 'timestampT': 'string', 'timeuuidT': 'string', 'tinyintT': 'string', 'tupleT': [ {'... recursive ...'}, ], 'uuidT': 'string', 'varcharT': 'string', 'varintT': 'string', 'udtT': { 'string': {'... recursive ...'} } }, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } } }, 'rowMetadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, 'oldImage': { 'valueCells': { 'string': { 'value': { 'asciiT': 'string', 'bigintT': 'string', 'blobT': b'bytes', 'boolT': True|False, 'counterT': 'string', 'dateT': 'string', 'decimalT': 'string', 'doubleT': 'string', 'floatT': 'string', 'inetT': 'string', 'intT': 'string', 'listT': [ {'... recursive ...'}, ], 'mapT': [ { 'key': {'... recursive ...'}, 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'setT': [ {'... recursive ...'}, ], 'smallintT': 'string', 'textT': 'string', 'timeT': 'string', 'timestampT': 'string', 'timeuuidT': 'string', 'tinyintT': 'string', 'tupleT': [ {'... recursive ...'}, ], 'uuidT': 'string', 'varcharT': 'string', 'varintT': 'string', 'udtT': { 'string': {'... recursive ...'} } }, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } } }, 'staticCells': { 'string': { 'value': { 'asciiT': 'string', 'bigintT': 'string', 'blobT': b'bytes', 'boolT': True|False, 'counterT': 'string', 'dateT': 'string', 'decimalT': 'string', 'doubleT': 'string', 'floatT': 'string', 'inetT': 'string', 'intT': 'string', 'listT': [ {'... recursive ...'}, ], 'mapT': [ { 'key': {'... recursive ...'}, 'value': {'... recursive ...'}, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, ], 'setT': [ {'... recursive ...'}, ], 'smallintT': 'string', 'textT': 'string', 'timeT': 'string', 'timestampT': 'string', 'timeuuidT': 'string', 'tinyintT': 'string', 'tupleT': [ {'... recursive ...'}, ], 'uuidT': 'string', 'varcharT': 'string', 'varintT': 'string', 'udtT': { 'string': {'... recursive ...'} } }, 'metadata': { 'expirationTime': 'string', 'writeTime': 'string' } } }, 'rowMetadata': { 'expirationTime': 'string', 'writeTime': 'string' } }, 'sequenceNumber': 'string' }, ], 'nextShardIterator': 'string' }
Response Structure
(dict) –
changeRecords (list) –
An array of change data records retrieved from the specified shard. Each record represents a single data modification (insert, update, or delete) to a row in the Amazon Keyspaces table. Records include the primary key columns and information about what data was modified.
(dict) –
Represents a change data capture record for a row in an Amazon Keyspaces table, containing both the new and old states of the row.
eventVersion (string) –
The version of the record format, used to track the evolution of the record structure over time.
createdAt (datetime) –
The timestamp indicating when this change data capture record was created.
origin (string) –
The origin or source of this change data capture record.
partitionKeys (dict) –
The partition key columns and their values for the affected row.
(string) –
(dict) –
Represents the value of a cell in an Amazon Keyspaces table, supporting various data types with type-specific fields.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
asciiT (string) –
A value of ASCII text type, containing US-ASCII characters.
bigintT (string) –
A 64-bit signed integer value.
blobT (bytes) –
A binary large object (BLOB) value stored as a Base64-encoded string.
boolT (boolean) –
A Boolean value, either
true
orfalse
.counterT (string) –
A distributed counter value that can be incremented and decremented.
dateT (string) –
A date value without a time component, represented as days since epoch (January 1, 1970).
decimalT (string) –
A variable-precision decimal number value.
doubleT (string) –
A 64-bit double-precision floating point value.
floatT (string) –
A 32-bit single-precision floating point value.
inetT (string) –
An IP address value, either IPv4 or IPv6 format.
intT (string) –
A 32-bit signed integer value.
listT (list) –
An ordered collection of elements that can contain duplicate values.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
mapT (list) –
A collection of key-value pairs where each key is unique.
(dict) –
Represents a key-value pair within a map data type in Amazon Keyspaces, including the associated metadata.
key (dict) –
The key of this map entry in the Amazon Keyspaces cell.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
value (dict) –
The value associated with the key in this map entry.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata for this specific key-value pair within the map, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
setT (list) –
An unordered collection of unique elements.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
smallintT (string) –
A 16-bit signed integer value.
textT (string) –
A UTF-8 encoded string value.
timeT (string) –
A time value without a date component, with nanosecond precision.
timestampT (string) –
A timestamp value representing date and time with millisecond precision.
timeuuidT (string) –
A universally unique identifier (UUID) that includes a timestamp component, ensuring both uniqueness and time ordering.
tinyintT (string) –
An 8-bit signed integer value.
tupleT (list) –
A fixed-length ordered list of elements, where each element can be of a different data type.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
uuidT (string) –
A universally unique identifier (UUID) value.
varcharT (string) –
A UTF-8 encoded string value, functionally equivalent to text type.
varintT (string) –
A variable precision integer value with arbitrary length.
udtT (dict) –
A user-defined type (UDT) value consisting of named fields, each with its own data type.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
clusteringKeys (dict) –
The clustering key columns and their values for the affected row, which determine the order of rows within a partition.
(string) –
(dict) –
Represents the value of a cell in an Amazon Keyspaces table, supporting various data types with type-specific fields.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
asciiT (string) –
A value of ASCII text type, containing US-ASCII characters.
bigintT (string) –
A 64-bit signed integer value.
blobT (bytes) –
A binary large object (BLOB) value stored as a Base64-encoded string.
boolT (boolean) –
A Boolean value, either
true
orfalse
.counterT (string) –
A distributed counter value that can be incremented and decremented.
dateT (string) –
A date value without a time component, represented as days since epoch (January 1, 1970).
decimalT (string) –
A variable-precision decimal number value.
doubleT (string) –
A 64-bit double-precision floating point value.
floatT (string) –
A 32-bit single-precision floating point value.
inetT (string) –
An IP address value, either IPv4 or IPv6 format.
intT (string) –
A 32-bit signed integer value.
listT (list) –
An ordered collection of elements that can contain duplicate values.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
mapT (list) –
A collection of key-value pairs where each key is unique.
(dict) –
Represents a key-value pair within a map data type in Amazon Keyspaces, including the associated metadata.
key (dict) –
The key of this map entry in the Amazon Keyspaces cell.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
value (dict) –
The value associated with the key in this map entry.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata for this specific key-value pair within the map, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
setT (list) –
An unordered collection of unique elements.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
smallintT (string) –
A 16-bit signed integer value.
textT (string) –
A UTF-8 encoded string value.
timeT (string) –
A time value without a date component, with nanosecond precision.
timestampT (string) –
A timestamp value representing date and time with millisecond precision.
timeuuidT (string) –
A universally unique identifier (UUID) that includes a timestamp component, ensuring both uniqueness and time ordering.
tinyintT (string) –
An 8-bit signed integer value.
tupleT (list) –
A fixed-length ordered list of elements, where each element can be of a different data type.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
uuidT (string) –
A universally unique identifier (UUID) value.
varcharT (string) –
A UTF-8 encoded string value, functionally equivalent to text type.
varintT (string) –
A variable precision integer value with arbitrary length.
udtT (dict) –
A user-defined type (UDT) value consisting of named fields, each with its own data type.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
newImage (dict) –
The state of the row after the change operation that generated this record.
valueCells (dict) –
A map of regular (non-static) column cells in the row, where keys are column names and values are the corresponding cells.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
asciiT (string) –
A value of ASCII text type, containing US-ASCII characters.
bigintT (string) –
A 64-bit signed integer value.
blobT (bytes) –
A binary large object (BLOB) value stored as a Base64-encoded string.
boolT (boolean) –
A Boolean value, either
true
orfalse
.counterT (string) –
A distributed counter value that can be incremented and decremented.
dateT (string) –
A date value without a time component, represented as days since epoch (January 1, 1970).
decimalT (string) –
A variable-precision decimal number value.
doubleT (string) –
A 64-bit double-precision floating point value.
floatT (string) –
A 32-bit single-precision floating point value.
inetT (string) –
An IP address value, either IPv4 or IPv6 format.
intT (string) –
A 32-bit signed integer value.
listT (list) –
An ordered collection of elements that can contain duplicate values.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
mapT (list) –
A collection of key-value pairs where each key is unique.
(dict) –
Represents a key-value pair within a map data type in Amazon Keyspaces, including the associated metadata.
key (dict) –
The key of this map entry in the Amazon Keyspaces cell.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
value (dict) –
The value associated with the key in this map entry.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata for this specific key-value pair within the map, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
setT (list) –
An unordered collection of unique elements.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
smallintT (string) –
A 16-bit signed integer value.
textT (string) –
A UTF-8 encoded string value.
timeT (string) –
A time value without a date component, with nanosecond precision.
timestampT (string) –
A timestamp value representing date and time with millisecond precision.
timeuuidT (string) –
A universally unique identifier (UUID) that includes a timestamp component, ensuring both uniqueness and time ordering.
tinyintT (string) –
An 8-bit signed integer value.
tupleT (list) –
A fixed-length ordered list of elements, where each element can be of a different data type.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
uuidT (string) –
A universally unique identifier (UUID) value.
varcharT (string) –
A UTF-8 encoded string value, functionally equivalent to text type.
varintT (string) –
A variable precision integer value with arbitrary length.
udtT (dict) –
A user-defined type (UDT) value consisting of named fields, each with its own data type.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
staticCells (dict) –
A map of static column cells shared by all rows with the same partition key, where keys are column names and values are the corresponding cells.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
asciiT (string) –
A value of ASCII text type, containing US-ASCII characters.
bigintT (string) –
A 64-bit signed integer value.
blobT (bytes) –
A binary large object (BLOB) value stored as a Base64-encoded string.
boolT (boolean) –
A Boolean value, either
true
orfalse
.counterT (string) –
A distributed counter value that can be incremented and decremented.
dateT (string) –
A date value without a time component, represented as days since epoch (January 1, 1970).
decimalT (string) –
A variable-precision decimal number value.
doubleT (string) –
A 64-bit double-precision floating point value.
floatT (string) –
A 32-bit single-precision floating point value.
inetT (string) –
An IP address value, either IPv4 or IPv6 format.
intT (string) –
A 32-bit signed integer value.
listT (list) –
An ordered collection of elements that can contain duplicate values.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
mapT (list) –
A collection of key-value pairs where each key is unique.
(dict) –
Represents a key-value pair within a map data type in Amazon Keyspaces, including the associated metadata.
key (dict) –
The key of this map entry in the Amazon Keyspaces cell.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
value (dict) –
The value associated with the key in this map entry.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata for this specific key-value pair within the map, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
setT (list) –
An unordered collection of unique elements.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
smallintT (string) –
A 16-bit signed integer value.
textT (string) –
A UTF-8 encoded string value.
timeT (string) –
A time value without a date component, with nanosecond precision.
timestampT (string) –
A timestamp value representing date and time with millisecond precision.
timeuuidT (string) –
A universally unique identifier (UUID) that includes a timestamp component, ensuring both uniqueness and time ordering.
tinyintT (string) –
An 8-bit signed integer value.
tupleT (list) –
A fixed-length ordered list of elements, where each element can be of a different data type.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
uuidT (string) –
A universally unique identifier (UUID) value.
varcharT (string) –
A UTF-8 encoded string value, functionally equivalent to text type.
varintT (string) –
A variable precision integer value with arbitrary length.
udtT (dict) –
A user-defined type (UDT) value consisting of named fields, each with its own data type.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
rowMetadata (dict) –
Metadata that applies to the entire row, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
oldImage (dict) –
The state of the row before the change operation that generated this record.
valueCells (dict) –
A map of regular (non-static) column cells in the row, where keys are column names and values are the corresponding cells.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
asciiT (string) –
A value of ASCII text type, containing US-ASCII characters.
bigintT (string) –
A 64-bit signed integer value.
blobT (bytes) –
A binary large object (BLOB) value stored as a Base64-encoded string.
boolT (boolean) –
A Boolean value, either
true
orfalse
.counterT (string) –
A distributed counter value that can be incremented and decremented.
dateT (string) –
A date value without a time component, represented as days since epoch (January 1, 1970).
decimalT (string) –
A variable-precision decimal number value.
doubleT (string) –
A 64-bit double-precision floating point value.
floatT (string) –
A 32-bit single-precision floating point value.
inetT (string) –
An IP address value, either IPv4 or IPv6 format.
intT (string) –
A 32-bit signed integer value.
listT (list) –
An ordered collection of elements that can contain duplicate values.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
mapT (list) –
A collection of key-value pairs where each key is unique.
(dict) –
Represents a key-value pair within a map data type in Amazon Keyspaces, including the associated metadata.
key (dict) –
The key of this map entry in the Amazon Keyspaces cell.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
value (dict) –
The value associated with the key in this map entry.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata for this specific key-value pair within the map, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
setT (list) –
An unordered collection of unique elements.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
smallintT (string) –
A 16-bit signed integer value.
textT (string) –
A UTF-8 encoded string value.
timeT (string) –
A time value without a date component, with nanosecond precision.
timestampT (string) –
A timestamp value representing date and time with millisecond precision.
timeuuidT (string) –
A universally unique identifier (UUID) that includes a timestamp component, ensuring both uniqueness and time ordering.
tinyintT (string) –
An 8-bit signed integer value.
tupleT (list) –
A fixed-length ordered list of elements, where each element can be of a different data type.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
uuidT (string) –
A universally unique identifier (UUID) value.
varcharT (string) –
A UTF-8 encoded string value, functionally equivalent to text type.
varintT (string) –
A variable precision integer value with arbitrary length.
udtT (dict) –
A user-defined type (UDT) value consisting of named fields, each with its own data type.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
staticCells (dict) –
A map of static column cells shared by all rows with the same partition key, where keys are column names and values are the corresponding cells.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
value (dict) –
The value stored in this cell, which can be of various data types supported by Amazon Keyspaces.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
asciiT (string) –
A value of ASCII text type, containing US-ASCII characters.
bigintT (string) –
A 64-bit signed integer value.
blobT (bytes) –
A binary large object (BLOB) value stored as a Base64-encoded string.
boolT (boolean) –
A Boolean value, either
true
orfalse
.counterT (string) –
A distributed counter value that can be incremented and decremented.
dateT (string) –
A date value without a time component, represented as days since epoch (January 1, 1970).
decimalT (string) –
A variable-precision decimal number value.
doubleT (string) –
A 64-bit double-precision floating point value.
floatT (string) –
A 32-bit single-precision floating point value.
inetT (string) –
An IP address value, either IPv4 or IPv6 format.
intT (string) –
A 32-bit signed integer value.
listT (list) –
An ordered collection of elements that can contain duplicate values.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
mapT (list) –
A collection of key-value pairs where each key is unique.
(dict) –
Represents a key-value pair within a map data type in Amazon Keyspaces, including the associated metadata.
key (dict) –
The key of this map entry in the Amazon Keyspaces cell.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
value (dict) –
The value associated with the key in this map entry.
Note
This is a Tagged Union structure. Only one of the following top level keys will be set:
asciiT
,bigintT
,blobT
,boolT
,counterT
,dateT
,decimalT
,doubleT
,floatT
,inetT
,intT
,listT
,mapT
,setT
,smallintT
,textT
,timeT
,timestampT
,timeuuidT
,tinyintT
,tupleT
,uuidT
,varcharT
,varintT
,udtT
. If a client receives an unknown member it will setSDK_UNKNOWN_MEMBER
as the top level key, which maps to the name or tag of the unknown member. The structure ofSDK_UNKNOWN_MEMBER
is as follows:'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
metadata (dict) –
Metadata for this specific key-value pair within the map, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
setT (list) –
An unordered collection of unique elements.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
smallintT (string) –
A 16-bit signed integer value.
textT (string) –
A UTF-8 encoded string value.
timeT (string) –
A time value without a date component, with nanosecond precision.
timestampT (string) –
A timestamp value representing date and time with millisecond precision.
timeuuidT (string) –
A universally unique identifier (UUID) that includes a timestamp component, ensuring both uniqueness and time ordering.
tinyintT (string) –
An 8-bit signed integer value.
tupleT (list) –
A fixed-length ordered list of elements, where each element can be of a different data type.
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
uuidT (string) –
A universally unique identifier (UUID) value.
varcharT (string) –
A UTF-8 encoded string value, functionally equivalent to text type.
varintT (string) –
A variable precision integer value with arbitrary length.
udtT (dict) –
A user-defined type (UDT) value consisting of named fields, each with its own data type.
(string) –
(dict) –
Represents a cell in an Amazon Keyspaces table, containing both the value and metadata about the cell.
metadata (dict) –
Metadata associated with this cell, such as time-to-live (TTL) expiration time and write timestamp.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
rowMetadata (dict) –
Metadata that applies to the entire row, such as timestamps and TTL information.
expirationTime (string) –
The time at which the associated data will expire, based on the time-to-live (TTL) setting.
writeTime (string) –
The timestamp at which the associated data was written to the database.
sequenceNumber (string) –
A unique identifier assigned to this record within the shard, used for ordering and tracking purposes.
nextShardIterator (string) –
The next position in the shard from which to start sequentially reading data records. If null, the shard has been closed and the requested iterator doesn’t return any more data.
Exceptions