Interface TableMetadata

All Known Implementing Classes:
StaticTableMetadata
@SdkPublicApi @ThreadSafe public interface TableMetadata
Interface for an object the stores structural information about a DynamoDb table.

  • Method Details

    • indexPartitionKeys

      default List<String> indexPartitionKeys(String indexName)
      Returns the attribute names of all the composite partition keys for an index.
      Parameters:
      indexName - The name of the index.
      Returns:
      A list of attribute names representing the composite partition keys for this index.
      Throws:
      IllegalArgumentException - if the index does not exist in the metadata or does not have partition keys associated with it.

    • indexPartitionKey

      default String indexPartitionKey(String indexName)
      Returns the attribute name of the single partition key for an index.

      Use indexPartitionKeys(String) for composite key support

      Parameters:
      indexName - The name of the index.
      Returns:
      The attribute name representing the first partition key for this index.
      Throws:
      IllegalArgumentException - if the index does not exist in the metadata or does not have a partition key associated with it.

    • indexSortKeys

      default List<String> indexSortKeys(String indexName)
      Returns the attribute names of all the composite sort keys for an index.
      Parameters:
      indexName - The name of the index.
      Returns:
      A list of attribute names representing the composite sort keys for this index.

    • indexSortKey

      default Optional<String> indexSortKey(String indexName)
      Returns the attribute name of the single sort key for an index.

      Use indexSortKeys(String) for composite key support

      Parameters:
      indexName - The name of the index.
      Returns:
      Optional of the attribute name representing the first sort key for this index; empty if the index does not have a sort key.

    • customMetadataObject

      <T> Optional<T> customMetadataObject(String key, Class<? extends T> objectClass)
      Returns a custom metadata object. These objects are used by extensions to the library, therefore the type of object stored is flexible and does not need to be known by the interface.
      Type Parameters:
      T - The flexible type for the object being returned. The compiler will typically infer this.
      Parameters:
      key - A unique key for the metadata object. This namespace is shared by all extensions, so it is recommended best practice to qualify it with the name of your extension.
      objectClass - The java class that the object will be cast to before returning. An exception will be thrown if the stored object cannot be cast to this class.
      Returns:
      An optional containing custom metadata object or empty if the object was not found.

    • indexKeys

      Collection<String> indexKeys(String indexName)
      Returns all the names of attributes associated with the keys of a specified index.
      Parameters:
      indexName - The name of the index.
      Returns:
      A collection of all key attribute names for that index.

    • allKeys

      @Deprecated Collection<String> allKeys()
      Deprecated.
      Use keyAttributes() instead.
      Returns all the names of attributes associated with any index (primary or secondary) known for this table. Additionally any additional attributes that are deemed to be 'key-like' in how they should be treated will also be returned. An example of a 'key-like' attribute that is not actually a key is one tagged as a 'version' attribute when using the versioned record extension.
      Returns:
      A collection of all key attribute names for the table.

    • indices

      Collection<IndexMetadata> indices()
      Returns metadata about all the known indices for this table.
      Returns:
      A collection of IndexMetadata containing information about the indices.

    • vectorIndices

      default Collection<VectorIndexMetadata> vectorIndices()
      Returns metadata about all the known vector indexes for this table. Vector indexes are distinct from global and local secondary indexes and are not included in indices().
      Returns:
      A collection of VectorIndexMetadata containing information about the vector indexes.

    • customMetadata

      Map<String,Object> customMetadata()
      Returns all custom metadata for this table. These entries are used by extensions to the library, therefore the value type of each metadata object stored in the map is not known and is provided as Object.

      This method should not be used to inspect individual custom metadata objects, instead use customMetadataObject(String, Class) ()} as that will perform a type-safety check on the retrieved object.

      Returns:
      A map of all the custom metadata for this table.

    • keyAttributes

      Collection<KeyAttributeMetadata> keyAttributes()
      Returns metadata about all the known 'key' attributes for this table, such as primary and secondary index keys, or any other attribute that forms part of the structure of the table.
      Returns:
      A collection of KeyAttributeMetadata containing information about the keys.

    • scalarAttributeType

      Optional<ScalarAttributeType> scalarAttributeType(String keyAttribute)
      Returns the DynamoDb scalar attribute type associated with a key attribute if one is applicable.
      Parameters:
      keyAttribute - The key attribute name to return the scalar attribute type of.
      Returns:
      Optional ScalarAttributeType of the attribute, or empty if attribute is a non-scalar type.
      Throws:
      IllegalArgumentException - if the keyAttribute is not found.

    • primaryPartitionKey

      default String primaryPartitionKey()
      Returns the attribute name used as the primary partition key for the table.
      Returns:
      The primary partition key attribute name.
      Throws:
      IllegalArgumentException - if the primary partition key is not known.

    • primarySortKey

      default Optional<String> primarySortKey()
      Returns the attribute name used as the primary sort key for the table.
      Returns:
      An optional of the primary sort key attribute name; empty if this key is not known.

    • primaryKeys

      default Collection<String> primaryKeys()
      Returns the names of the attributes that make up the primary key for the table.
      Returns:
      A collection of attribute names that make up the primary key for the table.

    • primaryIndexName

      static String primaryIndexName()
      Returns an arbitrary constant that should be used as the primary index name. This pattern creates a common abstraction and simplifies the implementation of operations that also work on secondary indices such as scan() and query().
      Returns:
      An arbitrary constant that internally represents the primary index name.