CassTableMeta¶

struct CassTableMeta¶

Table metadata

Public Functions

void cass_table_meta_name(const CassTableMeta *table_meta, const char **name, size_t *name_length)¶

Gets the name of the table.

Parameters

• table_meta – [in]

• name – [out]

• name_length – [out]

cass_bool_t cass_table_meta_is_virtual(const CassTableMeta *table_meta)¶

Determine if the table is a virtual table.

Parameters

table_meta – [in]

Returns

cass_true is the table is virtual, otherwise cass_false

const CassColumnMeta *cass_table_meta_column_by_name(const CassTableMeta *table_meta, const char *column)¶

Gets the column metadata for the provided column name.

Parameters

• table_meta – [in]

• column – [in]

Returns

The metadata for a column. NULL if column does not exist.

const CassColumnMeta *cass_table_meta_column_by_name_n(const CassTableMeta *table_meta, const char *column, size_t column_length)¶

Same as cass_table_meta_column_by_name(), but with lengths for string parameters.

See also

cass_table_meta_column_by_name()

Parameters

• table_meta – [in]

• column – [in]

• column_length – [in]

Returns

same as cass_table_meta_column_by_name()

size_t cass_table_meta_column_count(const CassTableMeta *table_meta)¶

Gets the total number of columns for the table.

Parameters

table_meta – [in]

Returns

The total column count.

const CassColumnMeta *cass_table_meta_column(const CassTableMeta *table_meta, size_t index)¶

Gets the column metadata for the provided index.

Parameters

• table_meta – [in]

• index – [in]

Returns

The metadata for a column. NULL returned if the index is out of range.

const CassIndexMeta *cass_table_meta_index_by_name(const CassTableMeta *table_meta, const char *index)¶

Gets the index metadata for the provided index name.

Parameters

• table_meta – [in]

• index – [in]

Returns

The metadata for a index. NULL if index does not exist.

const CassIndexMeta *cass_table_meta_index_by_name_n(const CassTableMeta *table_meta, const char *index, size_t index_length)¶

Same as cass_table_meta_index_by_name(), but with lengths for string parameters.

See also

cass_table_meta_index_by_name()

Parameters

• table_meta – [in]

• index – [in]

• index_length – [in]

Returns

same as cass_table_meta_index_by_name()

size_t cass_table_meta_index_count(const CassTableMeta *table_meta)¶

Gets the total number of indexes for the table.

Parameters

table_meta – [in]

Returns

The total index count.

const CassIndexMeta *cass_table_meta_index(const CassTableMeta *table_meta, size_t index)¶

Gets the index metadata for the provided index.

Parameters

• table_meta – [in]

• index – [in]

Returns

The metadata for a index. NULL returned if the index is out of range.

const CassMaterializedViewMeta *cass_table_meta_materialized_view_by_name(const CassTableMeta *table_meta, const char *view)¶

Gets the materialized view metadata for the provided view name.

Requires Apache Cassandra: 3.0+

Parameters

• table_meta – [in]

• view – [in]

Returns

The metadata for a view. NULL if view does not exist.

const CassMaterializedViewMeta *cass_table_meta_materialized_view_by_name_n(const CassTableMeta *table_meta, const char *view, size_t view_length)¶

Same as cass_table_meta_materialized_view_by_name(), but with lengths for string parameters.

Requires Apache Cassandra: 3.0+

See also

cass_table_meta_materialized_view_by_name()

Parameters

• table_meta – [in]

• view – [in]

• view_length – [in]

Returns

same as cass_table_meta_materialized_view_by_name()

size_t cass_table_meta_materialized_view_count(const CassTableMeta *table_meta)¶

Gets the total number of views for the table.

Requires Apache Cassandra: 3.0+

Parameters

table_meta – [in]

Returns

The total view count.

const CassMaterializedViewMeta *cass_table_meta_materialized_view(const CassTableMeta *table_meta, size_t index)¶

Gets the materialized view metadata for the provided index.

Requires Apache Cassandra: 3.0+

Parameters

• table_meta – [in]

• index – [in]

Returns

The metadata for a view. NULL returned if the index is out of range.

size_t cass_table_meta_partition_key_count(const CassTableMeta *table_meta)¶

Gets the number of columns for the table’s partition key.

Parameters

table_meta – [in]

Returns

The count for the number of columns in the partition key.

const CassColumnMeta *cass_table_meta_partition_key(const CassTableMeta *table_meta, size_t index)¶

Gets the partition key column metadata for the provided index.

See also

cass_table_meta_partition_key_count()

Parameters

• table_meta – [in]

• index – [in]

Returns

The metadata for a column. NULL returned if the index is out of range.

size_t cass_table_meta_clustering_key_count(const CassTableMeta *table_meta)¶

Gets the number of columns for the table’s clustering key.

Parameters

table_meta – [in]

Returns

The count for the number of columns in the clustering key.

const CassColumnMeta *cass_table_meta_clustering_key(const CassTableMeta *table_meta, size_t index)¶

Gets the clustering key column metadata for the provided index.

See also

cass_table_meta_clustering_key_count()

Parameters

• table_meta – [in]

• index – [in]

Returns

The metadata for a column. NULL returned if the index is out of range.

CassClusteringOrder cass_table_meta_clustering_key_order(const CassTableMeta *table_meta, size_t index)¶

Gets the clustering order column metadata for the provided index.

See also

cass_table_meta_clustering_key_count()

Parameters

• table_meta – [in]

• index – [in]

Returns

The clustering order for a column. CASS_CLUSTERING_ORDER_NONE returned if the index is out of range.

const CassValue *cass_table_meta_field_by_name(const CassTableMeta *table_meta, const char *name)¶

Gets a metadata field for the provided name. Metadata fields allow direct access to the column data found in the underlying “tables” metadata table.

Parameters

• table_meta – [in]

• name – [in]

Returns

A metadata field value. NULL if the field does not exist.

const CassValue *cass_table_meta_field_by_name_n(const CassTableMeta *table_meta, const char *name, size_t name_length)¶

Same as cass_table_meta_field_by_name(), but with lengths for string parameters.

See also

cass_table_meta_field_by_name()

Parameters

• table_meta – [in]

• name – [in]

• name_length – [in]

Returns

same as cass_table_meta_field_by_name()

CassIterator *cass_iterator_columns_from_table_meta(const CassTableMeta *table_meta)¶

Creates a new iterator for the specified table metadata. This can be used to iterate over columns.

See also

cass_iterator_get_column_meta()

See also

cass_iterator_free()

Parameters

table_meta – [in]

Returns

A new iterator that must be freed.

CassIterator *cass_iterator_indexes_from_table_meta(const CassTableMeta *table_meta)¶

Creates a new iterator for the specified table metadata. This can be used to iterate over indexes.

See also

cass_iterator_get_index_meta()

See also

cass_iterator_free()

Parameters

table_meta – [in]

Returns

A new iterator that must be freed.

CassIterator *cass_iterator_materialized_views_from_table_meta(const CassTableMeta *table_meta)¶

Creates a new iterator for the specified materialized view metadata. This can be used to iterate over columns.

Requires Apache Cassandra: 3.0+

See also

cass_iterator_get_materialized_view_meta()

See also

cass_iterator_free()

Parameters

table_meta – [in]

Returns

A new iterator that must be freed.

CassIterator *cass_iterator_fields_from_table_meta(const CassTableMeta *table_meta)¶

Creates a new fields iterator for the specified table metadata. Metadata fields allow direct access to the column data found in the underlying “tables” metadata table. This can be used to iterate those metadata field entries.

See also

cass_iterator_get_meta_field_name()

See also

cass_iterator_get_meta_field_value()

See also

cass_iterator_free()

Parameters

table_meta – [in]

Returns

A new iterator that must be freed.