@spec build_scalar_field(Milvex.Schema.Field.data_type(), list()) ::
  Milvex.Milvus.Proto.Schema.ScalarField.t()

Builds a ScalarField proto for the given data type and values.

@spec build_vector_field(Milvex.Schema.Field.data_type(), list(), pos_integer() | nil) ::
  Milvex.Milvus.Proto.Schema.VectorField.t()

Builds a VectorField proto for the given data type and values.

For dense vectors, values should be a list of lists (each inner list is a vector). For sparse vectors, values should be a list of tuple lists: [[{idx, val}, ...], ...].

@spec extract_scalar_values(Milvex.Milvus.Proto.Schema.ScalarField.t()) :: list()

Extracts values from a ScalarField proto.

@spec extract_vector_values(Milvex.Milvus.Proto.Schema.VectorField.t()) :: list()

Extracts values from a VectorField proto.

Returns vectors as lists for float vectors, or as-is for binary types. Sparse vectors are returned as tuple lists.

@spec from_proto(Milvex.Milvus.Proto.Schema.FieldData.t()) :: {String.t(), list()}

Extracts values from a FieldData proto struct.

Returns a tuple of {field_name, values} where values is a list.

Examples

iex> field_data = %FieldData{field_name: "age", scalars: %ScalarField{data: {:int_data, %IntArray{data: [25, 30]}}}}
iex> FieldData.from_proto(field_data)
{"age", [25, 30]}

@spec to_proto(String.t(), list(), Milvex.Schema.Field.t()) ::
  Milvex.Milvus.Proto.Schema.FieldData.t()

Converts a column of values to a FieldData proto struct.

Parameters

• field_name - Name of the field
• values - List of values for this column
• field_schema - The Field struct with type information

Examples

iex> field = Field.scalar("age", :int32)
iex> FieldData.to_proto("age", [25, 30, 35], field)
%FieldData{field_name: "age", type: :Int32, scalars: %ScalarField{...}}

@spec to_proto_dynamic(String.t(), [map()]) ::
  Milvex.Milvus.Proto.Schema.FieldData.t()

Converts dynamic field values to a FieldData proto struct with is_dynamic flag.

Used for dynamic fields when enable_dynamic_field is true on the schema. Each value should be a map representing the dynamic fields for that row.

Parameters

• field_name - Name of the dynamic field (typically "$meta")
• values - List of maps, one per row, containing the dynamic field values