GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PROTOCOL::CASSANDRACQL::COLUMNMETA (3)

.ds Aq ’

NAME

"Protocol::CassandraCQL::ColumnMeta" - stores the column metadata of a Cassandra CQL query

CONTENTS

DESCRIPTION

Objects in this class interpret the column metadata from a message frame containing a OPCODE_RESULT response to a query giving RESULT_ROWS or RESULT_PREPARED. It provides lookup of column names and type information, and provides a convenient accessor to the encoding and decoding support functions, allowing encoding of bytestrings from perl data when executing a prepared statement, and decoding of bytestrings to perl data when obtaining query results.

It is also subclassed as Protocol::CassandraCQL::Result.

CONSTRUCTORS

CW$meta = Protocol::CassandraCQL::ColumnMeta->from_frame( CW$frame, CW$version )

Returns a new column metadata object initialised from the given message frame at the given CQL version number. (Version will default to 1 if not supplied, but this may become a required parameter in a future version).

CW$meta = Protocol::CassandraCQL::ColumnMeta->new( CW%args )

Returns a new column metadata object initialised directly from the given column data. This constructor is intended for use by unit test scripts, to create metadata directly from mocked connection objects or similar.

It takes the following named arguments:
columns => ARRAY[ARRAY[STR, STR, STR, STR]] An ARRAY reference containing the data about individual columns. Each row is represented by an ARRAY reference containing four strings; giving the three components of its name, and the name of its type:



 [ $keyspace, $table, $column, $typename ]



METHODS

CW$n = CW$meta->columns

Returns the number of columns

CW$name = CW$meta->column_name( CW$idx )

( CW$keyspace, CW$table, CW$column ) = CW$meta->column_name( CW$idx )

Returns the name of the column at the given (0-based) index; either as three separate strings, or all joined by ..

CW$name = CW$meta->column_shortname( CW$idx )

Returns the short name of the column; which will be just the column name unless it requires the table or keyspace name as well to make it unique within the set.

CW$type = CW$meta->column_type( CW$idx )

Returns the type of the column at the given index as an instance of Protocol::CassandraCQL::Type.

CW$idx = CW$meta->find_column( CW$name )

Returns the index of the given named column. The name may be given as keyspace.table.column, or table.column or column if they are unique within the set. Returns undef if no such column exists.

CW@bytes = CW$meta->encode_data( CW@data )

Returns a list of encoded bytestrings from the given data according to the type of each column. Checks each value is valid; if not throws an exception explaining which column failed and why.

An exception is thrown if the wrong number of values is passed.

CW@data = CW$meta->decode_data( CW@bytes )

Returns a list of decoded data from the given encoded bytestrings according to the type of each column.

CW$bytes = CW$meta->paging_state

Returns the CQLv2+ paging state, if it was contained in the given frame. This would be returned in an OPCODE_RESULT message to a query or execute request that requested paging.

CW$bool = CW$meta->has_metadata

Returns a boolean indicating whether the column metadata (field names and types) is actually defined. Normally this would be true, except if the object is an instance of Protocol::CassandraCQL::Result returned by executing a prepared statement with metadata specifically disabled.

SPONSORS

This code was paid for by
o Perceptyx <http://www.perceptyx.com/>
o Shadowcat Systems <http://www.shadow.cat>

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PROTOCOL::CASSANDRACQL::COLUMNMETA (3) 2016-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.