Skip to content

SearchVectorsInput

Source code in docs_src/capo_dynamodb/types/search_vectors_input.py
class SearchVectorsInput(TypedDict, closed=True):
    table_name: "capo_dynamodb.types.table_arn.TableArn"
    """<p>The name or Amazon Resource Name (ARN) of the table containing the vector index.</p>"""
    index_name: "capo_dynamodb.types.index_name.IndexName"
    """<p>The name of the vector index to search. The index must be in the <code>ACTIVE</code> state.</p>"""
    return_consumed_capacity: NotRequired[
        "capo_dynamodb.types.return_consumed_capacity.ReturnConsumedCapacity"
    ]
    expression_attribute_names: NotRequired[
        "capo_dynamodb.types.expression_attribute_name_map.ExpressionAttributeNameMap"
    ]
    """<p>One or more substitution tokens for attribute names in an expression. Use the <code>#</code> character in an expression to dereference an attribute name.</p>"""
    expression_attribute_values: NotRequired[
        "capo_dynamodb.types.expression_attribute_value_map.ExpressionAttributeValueMap"
    ]
    """<p>One or more values that can be substituted in an expression. Use the <code>:</code> character in an expression to dereference an attribute value.</p>"""
    projection_expression: NotRequired[
        "capo_dynamodb.types.projection_expression.ProjectionExpression"
    ]
    """<p>A string that identifies one or more attributes to retrieve from the index. Separate attribute names with commas. If not specified, the operation returns all attributes projected into the vector index.</p> <p>Only attributes projected into the vector index can be retrieved.</p>"""
    search_vector: "capo_dynamodb.types.search_vector_list.SearchVectorList"
    """<p>The search vector to compare against the indexed vectors. Each element is a 32-bit IEEE-754 floating point number, provided in DynamoDB list format.</p> <p>The number of dimensions must match the number of dimensions configured for the vector index.</p>"""
    search_condition_expression: NotRequired["capo_dynamodb.types.string.String"]
    """<p>A condition expression used to filter the vector search results. The expression can reference attributes defined in the vector index search schema, including <code>HASH</code> and <code>INLINE_FILTER</code> key elements.</p> <p>Only the equality operator (<code>=</code>) is supported for <code>HASH</code> attributes. Comparison and range operators are supported for <code>INLINE_FILTER</code> attributes. Only top-level attributes from the search schema can be referenced.</p>"""
    top_k: "capo_dynamodb.types.top_k_integer.TopKInteger"
    """<p>The number of most similar results to return.</p>"""

expression_attribute_names instance-attribute

expression_attribute_names: NotRequired[ExpressionAttributeNameMap]

One or more substitution tokens for attribute names in an expression. Use the # character in an expression to dereference an attribute name.

expression_attribute_values instance-attribute

expression_attribute_values: NotRequired[ExpressionAttributeValueMap]

One or more values that can be substituted in an expression. Use the : character in an expression to dereference an attribute value.

index_name instance-attribute

index_name: IndexName

The name of the vector index to search. The index must be in the ACTIVE state.

projection_expression instance-attribute

projection_expression: NotRequired[ProjectionExpression]

A string that identifies one or more attributes to retrieve from the index. Separate attribute names with commas. If not specified, the operation returns all attributes projected into the vector index.

Only attributes projected into the vector index can be retrieved.

return_consumed_capacity instance-attribute

return_consumed_capacity: NotRequired[ReturnConsumedCapacity]

search_condition_expression instance-attribute

search_condition_expression: NotRequired[String]

A condition expression used to filter the vector search results. The expression can reference attributes defined in the vector index search schema, including HASH and INLINE_FILTER key elements.

Only the equality operator (=) is supported for HASH attributes. Comparison and range operators are supported for INLINE_FILTER attributes. Only top-level attributes from the search schema can be referenced.

search_vector instance-attribute

search_vector: SearchVectorList

The search vector to compare against the indexed vectors. Each element is a 32-bit IEEE-754 floating point number, provided in DynamoDB list format.

The number of dimensions must match the number of dimensions configured for the vector index.

table_name instance-attribute

table_name: TableArn

The name or Amazon Resource Name (ARN) of the table containing the vector index.

top_k instance-attribute

top_k: TopKInteger

The number of most similar results to return.