tiledb

package module
v0.17.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 21, 2022 License: MIT Imports: 17 Imported by: 1

README

TileDB logo

TileDB Go Bindings

GoDoc Build Status

This package provides TileDB golang bindings via cgo. The bindings have been designed to be idomatic Go. runtime.SetFinalizer is used to ensure proper free'ing of C heap allocated structures.

Installation

Supported Platforms

Currently the following platforms are supported:

  • Linux
  • macOS (OSX)
Prerequisites

This package requires the TileDB shared library be installed and on the system path. See the official TileDB installation instructions for installation methods. TileDB must be compiled with serialization support enabled.

Go Installation

To install these bindings you can use go get:

 go get -v github.com/TileDB-Inc/TileDB-Go

To install package test dependencies:

go get -v -t github.com/TileDB-Inc/TileDB-Go

Package tests can be run with:

go test github.com/TileDB-Inc/TileDB-Go

Compatibility

TileDB-Go follows semantic versioning. Currently TileDB core library does not, as such the below table reference which versions are compatible.

TileDB-Go Version TileDB Version
0.7.X 1.6.X
0.8.0 1.7.0
0.8.1 1.7.0
0.8.2 1.7.2
0.8.3 >=1.7.3
0.8.4 >=1.7.3
0.8.5 >=1.7.3
0.9.0 2.0.X
0.10.0 2.1.X
0.11.0 2.2.X
0.12.0 2.3.X
0.13.0 >=2.4.X
0.14.0 >=2.5.X
0.15.0 >=2.8.X
0.16.0 2.10.X
0.17.0 2.11.X

Missing Functionality

The following TileDB core library features are missing from the Go API:

  • TileDB generic object management
  • TileDB group creation

Documentation

Overview

Package tiledb is an idiomatic Go binding to tiledb's c_api. Go structs are used for object-style access to tiledb types, such as `Config` and `ArraySchema`. Tiledb C objects that are alloc'ed are set to be freeded on garbage collection using `runtime.SetFinalizer`.

For more information on TileDB see the official docs at https://docs.tiledb.io/en/stable .

Semantic versioning is followed for this package and for compatibility with Go modules. See the compatibility section of README.md for a mapping of TileDB-Go package to tiledb core library versions, https://github.com/TileDB-Inc/TileDB-Go/blob/master/README.md#compatibility .

Installation

See README.md for installation requirements and instructions: https://github.com/TileDB-Inc/TileDB-Go/blob/master/README.md#installation .

Quickstart

See `quickstart_dense_test.go` and `quickstart_sparse_test.go` for examples. Also check out the official tiledb quickstart docs at https://docs.tiledb.io/en/latest/quickstart.html

Index

Examples

Constants

View Source 
const (
	// Filestore autodetect mime type
	TILEDB_MIME_AUTODETECT = FileStoreMimeType(C.TILEDB_MIME_AUTODETECT)
	// Filestore TIFF mime type
	TILEDB_MIME_TIFF = FileStoreMimeType(C.TILEDB_MIME_TIFF)
	// Filestore PDF mime type
	TILEDB_MIME_PDF = FileStoreMimeType(C.TILEDB_MIME_PDF)
)

Mime types for TileDB filestore. The store can autodetect mime types but these are provided if the user wants to enforce a type

View Source 
const TILEDB_COORDS = "__coords"

TILEDB_COORDS A special name indicating the coordinates attribute.

Variables

View Source 
var TILEDB_VAR_NUM = uint32(C.TILEDB_VAR_NUM)

TILEDB_VAR_NUM indicates variable sized attributes for cell values

Functions

func DeserializeArrayMetadata added in v0.8.2 

func DeserializeArrayMetadata(a *Array, buffer *Buffer, serializationType SerializationType) error

DeserializeArrayMetadata deserializes array metadata

func DeserializeArrayNonEmptyDomainAllDimensions added in v0.9.0 

func DeserializeArrayNonEmptyDomainAllDimensions(a *Array, buffer *Buffer, serializationType SerializationType) error

DeserializeArrayNonEmptyDomainAllDimensions deserializes an array nonempty domain

func DeserializeQuery added in v0.6.0 

func DeserializeQuery(query *Query, buffer *Buffer, serializationType SerializationType, clientSide bool) error

DeserializeQuery deserializes a buffer into an existing query

func DeserializeQueryEstResultSizes added in v0.9.0 

func DeserializeQueryEstResultSizes(q *Query, buffer *Buffer, serializationType SerializationType, clientSide bool) error

DeserializeQueryEstResultSizes deserializes query estimated result sizes

func GetTimeFromTimestamp added in v0.9.0 

func GetTimeFromTimestamp(datatype Datatype, timestamp int64) time.Time

GetTimeFromTimestamp returns a time.Time object for a time related TileDB datatype Datetimes in TileDB are deltas from unix epoch with a resolution of the specified time

func ObjectMove added in v0.10.3 

func ObjectMove(tdbCtx *Context, path string, newPath string) error

ObjectMove moves a TileDB resource (group, array, key-value). Param path is the new path to move to

func ObjectRemove added in v0.10.3 

func ObjectRemove(tdbCtx *Context, path string) error

ObjectRemove deletes a TileDB resource (group, array, key-value).

func SerializeArray added in v0.17.1 

func SerializeArray(array *Array, serializationType SerializationType, clientSide bool) ([]byte, error)

SerializeArray serializes an array

func SerializeArrayMaxBufferSizes added in v0.6.0 

func SerializeArrayMaxBufferSizes(a *Array, subarray interface{}, serializationType SerializationType) ([]byte, error)

SerializeArrayMaxBufferSizes gets and serializes the array max buffer sizes for the given subarray

func SerializeArrayMetadata added in v0.8.2 

func SerializeArrayMetadata(a *Array, serializationType SerializationType) ([]byte, error)

SerializeArrayMetadata gets and serializes the array metadata

func SerializeArrayNonEmptyDomain added in v0.6.0 

func SerializeArrayNonEmptyDomain(a *Array, serializationType SerializationType) ([]byte, error)

SerializeArrayNonEmptyDomain gets and serializes the array nonempty domain

func SerializeArrayNonEmptyDomainAllDimensions added in v0.9.0 

func SerializeArrayNonEmptyDomainAllDimensions(a *Array, serializationType SerializationType) ([]byte, error)

SerializeArrayNonEmptyDomainAllDimensions gets and serializes the array nonempty domain

func SerializeArraySchema added in v0.6.0 

func SerializeArraySchema(schema *ArraySchema, serializationType SerializationType, clientSide bool) ([]byte, error)

SerializeArraySchema serializes an array schema

func SerializeQueryEstResultSizes added in v0.9.0 

func SerializeQueryEstResultSizes(q *Query, serializationType SerializationType, clientSide bool) ([]byte, error)

SerializeQueryEstResultSizes gets and serializes the query estimated result sizes

func Stats added in v0.11.6 

func Stats() (string, error)

Stats returns internal stats as string

func StatsDisable 

func StatsDisable() error

StatsDisable disable internal statistics gathering.

func StatsDump 

func StatsDump(path string) error

StatsDump prints internal stats to file path given

func StatsDumpSTDOUT 

func StatsDumpSTDOUT() error

StatsDumpSTDOUT prints internal stats to stdout

func StatsEnable 

func StatsEnable() error

StatsEnable enable internal statistics gathering

Example

Example usage of tiledb statistics 

err := StatsEnable()
if err != nil {
	// Handle error
}

// Perform tile operations
err = StatsDumpSTDOUT()
if err != nil {
	// Handle error
}

Output:

func StatsRaw added in v0.11.6 

func StatsRaw() (string, error)

StatsRaw returns internal raw (json) stats as string

func StatsRawDump added in v0.11.6 

func StatsRawDump(path string) error

StatsRawDump prints internal raw (json) stats to file path given

func StatsRawDumpSTDOUT added in v0.11.6 

func StatsRawDumpSTDOUT() error

StatsRawDumpSTDOUT prints internal raw (json) stats to stdout

func StatsReset 

func StatsReset() error

StatsReset reset all internal statistics counters to 0.

func Version 

func Version() (major int, minor int, rev int)

Version returns the TileDB shared library version these bindings are linked against at runtime

Example 
major, minor, rev := Version()
fmt.Printf("TileDB shared library version is %d.%d.%d", major, minor, rev)

Output:

Types

type Array 

type Array struct {
	// contains filtered or unexported fields
}

Array struct representing a TileDB array object.

An Array object represents array data in TileDB at some persisted location, e.g. on disk, in an S3 bucket, etc. Once an array has been opened for reading or writing, interact with the data through Query objects.

func DeserializeArray added in v0.17.1 

func DeserializeArray(buffer *Buffer, serializationType SerializationType, clientSide bool) (*Array, error)

DeserializeArray deserializes a new array from the given buffer

func NewArray 

func NewArray(tdbCtx *Context, uri string) (*Array, error)

NewArray alloc a new array

Example 
// Create Config, this is optional
config, err := NewConfig()
if err != nil {
	// Handle error
	return
}

// Test context with config
context, err := NewContext(config)
if err != nil {
	// Handle error
	return
}

// Create Dimension
dimension, err := NewDimension(context, "test", TILEDB_INT32, []int32{1, 10}, 5)
if err != nil {
	// Handle error
	return
}

// Create Domain
domain, err := NewDomain(context)
if err != nil {
	// Handle error
	return
}

// Add dimension to domain
err = domain.AddDimensions(dimension)
if err != nil {
	// Handle error
	return
}

arraySchema, err := NewArraySchema(context, TILEDB_DENSE)
if err != nil {
	// Handle error
	return
}

// Crete attribute to add to schema
attribute, err := NewAttribute(context, "a1", TILEDB_INT32)

if err != nil {
	// Handle error
	return
}

err = arraySchema.AddAttributes(attribute)
if err != nil {
	// Handle error
	return
}

err = arraySchema.SetDomain(domain)
if err != nil {
	// Handle error
	return
}

array, err := NewArray(context, "my_array")
if err != nil {
	// Handle error
	return
}

err = array.Create(arraySchema)
if err != nil {
	// Handle error
	return
}

Output:

func (*Array) Close 

func (a *Array) Close() error

Close a tiledb array, this is called on garbage collection automatically

func (*Array) Config added in v0.17.1 

func (a *Array) Config() (*Config, error)

Config get config on query

func (*Array) Consolidate 

func (a *Array) Consolidate(config *Config) error

Consolidate Consolidates the fragments of an array into a single fragment. You must first finalize all queries to the array before consolidation can begin (as consolidation temporarily acquires an exclusive lock on the array).

func (*Array) Context added in v0.14.2 

func (a *Array) Context() *Context

Context exposes the internal TileDB context used to initialize the array

func (*Array) Create 

func (a *Array) Create(arraySchema *ArraySchema) error

Create a new TileDB array given an input schema.

func (*Array) DeleteMetadata added in v0.8.1 

func (a *Array) DeleteMetadata(key string) error

DeleteMetadata deletes a metadata key-value item from an open array. The array must be opened in WRITE mode, otherwise the function will error out.

func (*Array) Free 

func (a *Array) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Array) GetMetadata added in v0.8.1 

func (a *Array) GetMetadata(key string) (Datatype, uint, interface{}, error)

GetMetadata gets a metadata key-value item from an open array. The array must be opened in READ mode, otherwise the function will error out.

func (*Array) GetMetadataFromIndex added in v0.8.1 

func (a *Array) GetMetadataFromIndex(index uint64) (*ArrayMetadata, error)

GetMetadataFromIndex gets a metadata item from an open array using an index. The array must be opened in READ mode, otherwise the function will error out.

func (*Array) GetMetadataFromIndexWithValueLimit added in v0.8.5 

func (a *Array) GetMetadataFromIndexWithValueLimit(index uint64, limit *uint) (*ArrayMetadata, error)

GetMetadataFromIndexWithValueLimit gets a metadata item from an open array using an index. The array must be opened in READ mode, otherwise the function will error out. limit parameter limits the number of values returned if string or array This is helpful for pushdown of limitting metadata. If nil value is returned in full

func (*Array) GetMetadataMap added in v0.8.1 

func (a *Array) GetMetadataMap() (map[string]*ArrayMetadata, error)

GetMetadataMap returns a map[string]*ArrayMetadata where key is the key of each metadata added and value is an ArrayMetadata struct. The map contains all array metadata previously added

func (*Array) GetMetadataMapWithValueLimit added in v0.8.5 

func (a *Array) GetMetadataMapWithValueLimit(limit *uint) (map[string]*ArrayMetadata, error)

GetMetadataMapWithValueLimit returns a map[string]*ArrayMetadata where key is the key of each metadata added and value is an ArrayMetadata struct. The map contains all array metadata previously added limit parameter limits the number of values returned if string or array This is helpful for pushdown of limitting metadata. If nil value is returned in full

func (*Array) GetMetadataNum added in v0.8.1 

func (a *Array) GetMetadataNum() (uint64, error)

GetMetadataNum gets then number of metadata items in an open array. The array must be opened in READ mode, otherwise the function will error out.

func (Array) GetNonEmptyDomainSliceFromIndex added in v0.11.0 

func (a Array) GetNonEmptyDomainSliceFromIndex(dimIdx uint) (*Dimension, interface{}, unsafe.Pointer, error)

func (Array) GetNonEmptyDomainSliceFromName added in v0.11.0 

func (a Array) GetNonEmptyDomainSliceFromName(dimName string) (*Dimension, interface{}, unsafe.Pointer, error)

func (*Array) NonEmptyDomain 

func (a *Array) NonEmptyDomain() ([]NonEmptyDomain, bool, error)

NonEmptyDomain retrieves the non-empty domain from an array This returns the bounding coordinates for each dimension

func (*Array) NonEmptyDomainFromIndex added in v0.9.0 

func (a *Array) NonEmptyDomainFromIndex(dimIdx uint) (*NonEmptyDomain, bool, error)

NonEmptyDomainFromIndex retrieves the non-empty domain from an array for a given fixed-sized dimension index. Returns the bounding coordinates for the dimension

func (*Array) NonEmptyDomainFromName added in v0.9.0 

func (a *Array) NonEmptyDomainFromName(dimName string) (*NonEmptyDomain, bool, error)

NonEmptyDomainFromName retrieves the non-empty domain from an array for a given fixed-sized dimension name Returns the bounding coordinates for the dimension

func (*Array) NonEmptyDomainMap added in v0.11.9 

func (a *Array) NonEmptyDomainMap() (map[string]interface{}, error)

NonEmptyDomainMap returns a map[string]interface{} where key is the dimension name and value is the non empty domain for the given dimension or the empty interface. It covers both var-sized and non-var-sized dimensions

func (*Array) NonEmptyDomainVarFromIndex added in v0.9.0 

func (a *Array) NonEmptyDomainVarFromIndex(dimIdx uint) (*NonEmptyDomain, bool, error)

NonEmptyDomainVarFromIndex retrieves the non-empty domain from an array for a given var-sized dimension index. Supports only TILEDB_STRING_ASCII type Returns the bounding coordinates for the dimension

func (*Array) NonEmptyDomainVarFromName added in v0.9.0 

func (a *Array) NonEmptyDomainVarFromName(dimName string) (*NonEmptyDomain, bool, error)

NonEmptyDomainVarFromName retrieves the non-empty domain from an array for a given var-sized dimension name. Supports only TILEDB_STRING_ASCII type Returns the bounding coordinates for the dimension

func (*Array) Open 

func (a *Array) Open(queryType QueryType) error

Open the array. The array is opened using a query type as input. This is to indicate that queries created for this Array object will inherit the query type. In other words, Array objects are opened to receive only one type of queries. They can always be closed and be re-opened with another query type. Also there may be many different Array objects created and opened with different query types. For instance, one may create and open an array object array_read for reads and another one array_write for writes, and interleave creation and submission of queries for both these array objects.

func (*Array) OpenEndTimestamp added in v0.12.0 

func (a *Array) OpenEndTimestamp() (uint64, error)

OpenEndTimestamp returns the current end_timestamp value of an open array

func (*Array) OpenStartTimestamp added in v0.12.0 

func (a *Array) OpenStartTimestamp() (uint64, error)

OpenStartTimestamp returns the current start_timestamp value of an open array

func (*Array) OpenWithOptions added in v0.12.0 

func (a *Array) OpenWithOptions(queryType QueryType, opts ...ArrayOpenOption) error

Open the array with options. The array is opened using a query type as input. This is to indicate that queries created for this Array object will inherit the query type. In other words, Array objects are opened to receive only one type of query. They can always be closed and be re-opened with another query type. Also there may be many different Array objects created and opened with different query types. For instance, one may create and open an array object array_read for reads and another one array_write for writes, and interleave creation and submission of queries for both these array objects.

func (*Array) PutCharMetadata added in v0.9.1 

func (a *Array) PutCharMetadata(key string, charData string) error

PutCharMetadata adds char metadata to array

func (*Array) PutMetadata added in v0.8.1 

func (a *Array) PutMetadata(key string, value interface{}) error

PutMetadata puts a metadata key-value item to an open array. The array must be opened in WRITE mode, otherwise the function will error out.

func (*Array) QueryType 

func (a *Array) QueryType() (QueryType, error)

QueryType return the current query type of an open array

func (*Array) Reopen 

func (a *Array) Reopen() error

Reopen the array (the array must be already open). This is useful when the array got updated after it got opened and the Array object got created. To sync-up with the updates, the user must either close the array and open with open(), or just use reopen() without closing. This function will be generally faster than the former alternative.

func (*Array) Schema 

func (a *Array) Schema() (*ArraySchema, error)

Schema returns the ArraySchema for the array

func (*Array) SetConfig added in v0.17.1 

func (a *Array) SetConfig(config *Config) error

SetConfig config on query

func (*Array) URI added in v0.2.0 

func (a *Array) URI() (string, error)

URI returns the array's uri

func (*Array) Vacuum added in v0.10.0 

func (a *Array) Vacuum(config *Config) error

Vacuum cleans up the array, such as consolidated fragments and array metadata

type ArrayMetadata added in v0.8.1 

type ArrayMetadata struct {
	Key      string
	KeyLen   uint32
	Datatype Datatype
	ValueNum uint
	Value    interface{}
}

ArrayMetadata defines metadata for the array

func (ArrayMetadata) MarshalJSON added in v0.8.1 

func (a ArrayMetadata) MarshalJSON() ([]byte, error)

MarshalJSON implements the Marshaler interface for ArrayMetadata

type ArrayOpenOption added in v0.12.0 

type ArrayOpenOption func(tdbArray *Array) error

ArrayOpenOptions define the flexibile parameters in which arrays can be opened with.

func WithEndTimestamp added in v0.12.0 

func WithEndTimestamp(endTimestamp uint64) ArrayOpenOption

WithEndTimestamp sets the subsequent Open call to use the end_timestamp of the passed value.

func WithStartTimestamp added in v0.12.0 

func WithStartTimestamp(startTimestamp uint64) ArrayOpenOption

WithStartTimestamp sets the subsequent Open call to use the start_timestamp of the passed value.

type ArraySchema 

type ArraySchema struct {
	// contains filtered or unexported fields
}

ArraySchema Schema describing an array.

The schema is an independent description of an array. A schema can be used to create multiple array’s, and stores information about its domain, cell types, and compression details. An array schema is composed of: 

A Domain
A set of Attributes
Memory layout definitions: tile and cell
Compression details for Array level factors like offsets and coordinates

func DeserializeArraySchema added in v0.6.0 

func DeserializeArraySchema(buffer *Buffer, serializationType SerializationType, clientSide bool) (*ArraySchema, error)

DeserializeArraySchema deserializes a new array schema from the given buffer

func LoadArraySchema 

func LoadArraySchema(context *Context, path string) (*ArraySchema, error)

LoadArraySchema reads a directory for a ArraySchema

func NewArraySchema 

func NewArraySchema(tdbCtx *Context, arrayType ArrayType) (*ArraySchema, error)

NewArraySchema alloc a new ArraySchema

Example 
// Create Config, this is optional
config, err := NewConfig()
if err != nil {
	// Handle error
	return
}

// Test context with config
context, err := NewContext(config)
if err != nil {
	// Handle error
	return
}

// Create Dimension
dimension, err := NewDimension(context, "test", TILEDB_INT32, []int32{1, 10}, 5)
if err != nil {
	// Handle error
	return
}

// Create Domain
domain, err := NewDomain(context)
if err != nil {
	// Handle error
	return
}

// Add dimension to domain
err = domain.AddDimensions(dimension)
if err != nil {
	// Handle error
	return
}

arraySchema, err := NewArraySchema(context, TILEDB_DENSE)
if err != nil {
	// Handle error
	return
}

// Crete attribute to add to schema
attribute, err := NewAttribute(context, "a1", TILEDB_INT32)

if err != nil {
	// Handle error
	return
}

err = arraySchema.AddAttributes(attribute)
if err != nil {
	// Handle error
	return
}

Output:

func (*ArraySchema) AddAttributes 

func (a *ArraySchema) AddAttributes(attributes ...*Attribute) error

AddAttributes add one or more attributes to the array

func (*ArraySchema) AllowsDups added in v0.10.3 

func (a *ArraySchema) AllowsDups() (bool, error)

AllowsDups Gets whether the array can allow coordinate duplicates or not. It should always be `0` for dense arrays.

func (*ArraySchema) AttributeFromIndex 

func (a *ArraySchema) AttributeFromIndex(index uint) (*Attribute, error)

AttributeFromIndex get a copy of an Attribute in the schema by name.

func (*ArraySchema) AttributeFromName 

func (a *ArraySchema) AttributeFromName(attrName string) (*Attribute, error)

AttributeFromName Get a copy of an Attribute in the schema by index. Attributes are ordered the same way they were defined when constructing the array schema.

func (*ArraySchema) AttributeNum 

func (a *ArraySchema) AttributeNum() (uint, error)

AttributeNum returns the number of attributes

func (*ArraySchema) Attributes 

func (a *ArraySchema) Attributes() ([]*Attribute, error)

Attributes gets all attributes in the array.

func (*ArraySchema) Capacity 

func (a *ArraySchema) Capacity() (uint64, error)

Capacity returns the tile capacity.

func (*ArraySchema) CellOrder 

func (a *ArraySchema) CellOrder() (Layout, error)

CellOrder return the cell order

func (*ArraySchema) Check 

func (a *ArraySchema) Check() error

Check validates the schema

func (*ArraySchema) Context added in v0.14.2 

func (a *ArraySchema) Context() *Context

Context exposes the internal TileDB context used to initialize the array schema

func (*ArraySchema) CoordsFilterList added in v0.2.0 

func (a *ArraySchema) CoordsFilterList() (*FilterList, error)

CoordsFilterList Returns a copy of the filter list of the coordinates.

func (*ArraySchema) Domain 

func (a *ArraySchema) Domain() (*Domain, error)

Domain returns the array's domain

func (*ArraySchema) Dump 

func (a *ArraySchema) Dump(path string) error

Dump Dumps the array schema in ASCII format in the selected output.

func (*ArraySchema) DumpSTDOUT 

func (a *ArraySchema) DumpSTDOUT() error

DumpSTDOUT Dumps the array schema in ASCII format to stdout

func (*ArraySchema) Free 

func (a *ArraySchema) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*ArraySchema) HasAttribute added in v0.10.3 

func (a *ArraySchema) HasAttribute(attrName string) (bool, error)

HasAttribute returns true if attribute: `attrName` is part of the schema

func (*ArraySchema) MarshalJSON added in v0.6.0 

func (a *ArraySchema) MarshalJSON() ([]byte, error)

MarshalJSON marshal arraySchema struct to json using tiledb

func (*ArraySchema) OffsetsFilterList added in v0.2.0 

func (a *ArraySchema) OffsetsFilterList() (*FilterList, error)

OffsetsFilterList returns a copy of the FilterList of the offsets for variable-length attributes.

func (*ArraySchema) SetAllowsDups added in v0.10.3 

func (a *ArraySchema) SetAllowsDups(allowsDups bool) error

SetAllowsDups Sets whether the array can allow coordinate duplicates or not. Applicable only to sparse arrays (it errors out if set to `1` for dense arrays).

func (*ArraySchema) SetCapacity 

func (a *ArraySchema) SetCapacity(capacity uint64) error

SetCapacity sets the tile capacity.

func (*ArraySchema) SetCellOrder 

func (a *ArraySchema) SetCellOrder(cellOrder Layout) error

SetCellOrder set the cell order

func (*ArraySchema) SetCoordsFilterList added in v0.2.0 

func (a *ArraySchema) SetCoordsFilterList(filterList *FilterList) error

SetCoordsFilterList sets the filter list used for coordinates

func (*ArraySchema) SetDomain 

func (a *ArraySchema) SetDomain(domain *Domain) error

SetDomain sets the array domain

func (*ArraySchema) SetOffsetsFilterList added in v0.2.0 

func (a *ArraySchema) SetOffsetsFilterList(filterList *FilterList) error

SetOffsetsFilterList sets the filter list for the offsets of variable-length attributes

func (*ArraySchema) SetTileOrder 

func (a *ArraySchema) SetTileOrder(tileOrder Layout) error

SetTileOrder set the tile order

func (*ArraySchema) TileOrder 

func (a *ArraySchema) TileOrder() (Layout, error)

TileOrder return the tile order

func (*ArraySchema) Type added in v0.6.0 

func (a *ArraySchema) Type() (ArrayType, error)

Type fetch the tiledb array type

func (*ArraySchema) UnmarshalJSON added in v0.6.0 

func (a *ArraySchema) UnmarshalJSON(b []byte) error

UnmarshalJSON marshal arraySchema struct to json using tiledb

type ArrayType 

type ArrayType int8

ArrayType enum for tiledb arrays 

const (
	// TILEDB_DENSE dense array
	TILEDB_DENSE ArrayType = C.TILEDB_DENSE
	// TILEDB_SPARSE dense array
	TILEDB_SPARSE ArrayType = C.TILEDB_SPARSE
)

type Attribute 

type Attribute struct {
	// contains filtered or unexported fields
}

Attribute describes an attribute of an Array cell.

An attribute specifies a name and datatype for a particular value in each array cell. There are 3 supported attribute types: 

Fundamental types, such as char, int, double, uint64, etc..
Fixed sized arrays: [N]T or make([]T, N), where T is a fundamental type
Variable length data: string, []T, where T is a fundamental type

func NewAttribute 

func NewAttribute(context *Context, name string, datatype Datatype) (*Attribute, error)

NewAttribute alloc a new attribute

Example 
// Create Config, this is optional
config, err := NewConfig()
if err != nil {
	// Handle error
	return
}

// Test context with config
context, err := NewContext(config)
if err != nil {
	// Handle error
	return
}

// Create Attribute
attribute, err := NewAttribute(context, "test", TILEDB_INT32)
if err != nil {
	// Handle error
	return
}

// Set Filter List
filter, err := NewFilter(context, TILEDB_FILTER_GZIP)
if err != nil {
	// Handle error
	return
}
filterList, err := NewFilterList(context)
if err != nil {
	// Handle error
	return
}
err = filterList.AddFilter(filter)
if err != nil {
	// Handle error
	return
}
err = attribute.SetFilterList(filterList)
if err != nil {
	// Handle error
	return
}

// Set Cell Value Number
err = attribute.SetCellValNum(10)
if err != nil {
	// Handle error
	return
}

Output:

func (*Attribute) CellSize added in v0.10.3 

func (a *Attribute) CellSize() (uint64, error)

CellSize gets attribute cell size

func (*Attribute) CellValNum 

func (a *Attribute) CellValNum() (uint32, error)

CellValNum returns number of values of one cell on this attribute. For variable-sized attributes returns TILEDB_VAR_NUM.

func (*Attribute) Context added in v0.14.2 

func (a *Attribute) Context() *Context

Context exposes the internal TileDB context used to initialize the attribute

func (*Attribute) Dump 

func (a *Attribute) Dump(path string) error

Dump Dumps the attribute in ASCII format in the selected output.

func (*Attribute) DumpSTDOUT 

func (a *Attribute) DumpSTDOUT() error

DumpSTDOUT Dumps the attribute in ASCII format to stdout

func (*Attribute) FilterList added in v0.2.0 

func (a *Attribute) FilterList() (*FilterList, error)

FilterList returns a copy of the filter list for attribute

func (*Attribute) Free 

func (a *Attribute) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Attribute) GetFillValue added in v0.10.3 

func (a *Attribute) GetFillValue() (interface{}, uint64, error)

GetFillValue Gets the default fill value for the input attribute. This value will be used for the input attribute whenever querying (1) an empty cell in a dense array, or (2) a non-empty cell (in either dense or sparse array) when values on the input attribute are missing (e.g., if the user writes a subset of the attributes in a write operation). Applicable to both fixed-sized and var-sized attributes.

func (*Attribute) GetFillValueNullable added in v0.11.0 

func (a *Attribute) GetFillValueNullable() (interface{}, uint64, bool, error)

GetFillValueNullable Gets the default fill value for the input attribute. This value will be used for the input attribute whenever querying (1) an empty cell in a dense array, or (2) a non-empty cell (in either dense or sparse array) when values on the input attribute are missing (e.g., if the user writes a subset of the attributes in a write operation). Applicable to both fixed-sized and var-sized attributes.

func (*Attribute) Name 

func (a *Attribute) Name() (string, error)

Name returns name of attribute

func (*Attribute) Nullable added in v0.11.0 

func (a *Attribute) Nullable() (bool, error)

Nullable returns if the attribute is nullable or not.

func (*Attribute) SetCellValNum 

func (a *Attribute) SetCellValNum(val uint32) error

SetCellValNum Sets the number of attribute values per cell. This is inferred from the type parameter of the NewAttribute function, but can also be set manually.

func (*Attribute) SetFillValue added in v0.10.3 

func (a *Attribute) SetFillValue(value interface{}) error

SetFillValue Sets the default fill value for the input attribute. This value will be used for the input attribute whenever querying (1) an empty cell in a dense array, or (2) a non-empty cell (in either dense or sparse array) when values on the input attribute are missing (e.g., if the user writes a subset of the attributes in a write operation). Applicable to var-sized attributes. @note A call to `tiledb_attribute_cell_val_num` sets the fill value 

of the attribute to its default. Therefore, make sure you invoke
`tiledb_attribute_set_fill_value` after deciding on the number
of values this attribute will hold in each cell.

@note For fixed-sized attributes, the input `size` should be equal 

to the cell size.

func (*Attribute) SetFillValueNullable added in v0.11.0 

func (a *Attribute) SetFillValueNullable(value interface{}, valid bool) error

SetFillValueNullable Sets the default fill value for the input attribute. This value will be used for the input attribute whenever querying (1) an empty cell in a dense array, or (2) a non-empty cell (in either dense or sparse array) when values on the input attribute are missing (e.g., if the user writes a subset of the attributes in a write operation). Applicable to var-sized attributes. @note A call to `tiledb_attribute_cell_val_num` sets the fill value 

of the attribute to its default. Therefore, make sure you invoke
`tiledb_attribute_set_fill_value` after deciding on the number
of values this attribute will hold in each cell.

@note For fixed-sized attributes, the input `size` should be equal 

to the cell size.

func (*Attribute) SetFilterList added in v0.2.0 

func (a *Attribute) SetFilterList(filterlist *FilterList) error

SetFilterList sets the attribute filterList

Example 
// Create configuration
config, err := NewConfig()
if err != nil {
	// Handle error
	return
}

// Test context with config
context, err := NewContext(config)
if err != nil {
	// Handle error
	return
}

attribute, err := NewAttribute(context, "test", TILEDB_INT32)
if err != nil {
	// Handle error
	return
}
// Set Filter List
filter, err := NewFilter(context, TILEDB_FILTER_GZIP)
if err != nil {
	// Handle error
	return
}

err = filter.SetOption(TILEDB_COMPRESSION_LEVEL, int32(5))
if err != nil {
	// Handle error
	return
}

filterList, err := NewFilterList(context)
if err != nil {
	// Handle error
	return
}
err = filterList.AddFilter(filter)
if err != nil {
	// Handle error
	return
}
err = attribute.SetFilterList(filterList)
if err != nil {
	// Handle error
	return
}

Output:

func (*Attribute) SetNullable added in v0.11.0 

func (a *Attribute) SetNullable(nullable bool) error

SetNullable Sets if the attribute is nullable or not.

func (*Attribute) Type 

func (a *Attribute) Type() (Datatype, error)

Type returns the attribute datatype

type Buffer added in v0.6.0 

type Buffer struct {
	// contains filtered or unexported fields
}

Buffer A generic Buffer object used by some TileDB APIs

func NewBuffer added in v0.6.0 

func NewBuffer(context *Context) (*Buffer, error)

NewBuffer Allocs a new buffer

Example 
// Create context with default config
context, err := NewContext(nil)
if err != nil {
	// Handle error
	return
}

// Create Buffer
buffer, err := NewBuffer(context)
if err != nil {
	// Handle error
	return
}

// Get data slice
bytes, err := buffer.dataCopy()
if err != nil {
	// Handle error
	return
}
fmt.Println(bytes)

Output:

[]

func (*Buffer) Context added in v0.14.2 

func (b *Buffer) Context() *Context

Context exposes the internal TileDB context used to initialize the buffer

func (*Buffer) Free added in v0.6.0 

func (b *Buffer) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Buffer) Serialize added in v0.15.1 

func (b *Buffer) Serialize(serializationType SerializationType) ([]byte, error)

Serialize returns a copy of the bytes in the buffer.

func (*Buffer) SetBuffer added in v0.6.0 

func (b *Buffer) SetBuffer(buffer []byte) error

SetBuffer sets the data pointer and size on the Buffer to the given slice

func (*Buffer) SetType added in v0.6.0 

func (b *Buffer) SetType(datatype Datatype) error

SetType sets buffer datatype

func (*Buffer) Type added in v0.6.0 

func (b *Buffer) Type() (Datatype, error)

Type returns the buffer datatype

type BufferList added in v0.6.0 

type BufferList struct {
	// contains filtered or unexported fields
}

BufferList A list of TileDB BufferList objects

func NewBufferList added in v0.6.0 

func NewBufferList(context *Context) (*BufferList, error)

NewBufferList Allocs a new buffer list

Example 
// Create context with default config
context, err := NewContext(nil)
if err != nil {
	// Handle error
	return
}

// Create BufferList
bufferList, err := NewBufferList(context)
if err != nil {
	// Handle error
	return
}

// Get num buffers
numBuffers, err := bufferList.NumBuffers()
if err != nil {
	// Handle error
	return
}
fmt.Println(numBuffers)

Output:

0

func SerializeQuery added in v0.6.0 

func SerializeQuery(query *Query, serializationType SerializationType, clientSide bool) (*BufferList, error)

SerializeQuery serializes a query

func (*BufferList) Context added in v0.14.2 

func (b *BufferList) Context() *Context

Context exposes the internal TileDB context used to initialize the buffer list

func (*BufferList) Flatten added in v0.6.0 

func (b *BufferList) Flatten() (*Buffer, error)

Flatten copies and concatenates all buffers in the list into a new buffer

func (*BufferList) Free added in v0.6.0 

func (b *BufferList) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*BufferList) GetBuffer added in v0.6.0 

func (b *BufferList) GetBuffer(bufferIndex uint) (*Buffer, error)

GetBuffer returns a Buffer at the given index in the list

func (*BufferList) NumBuffers added in v0.6.0 

func (b *BufferList) NumBuffers() (uint64, error)

NumBuffers returns number of buffers in the list

func (*BufferList) TotalSize added in v0.6.0 

func (b *BufferList) TotalSize() (uint64, error)

TotalSize returns total number of bytes in the buffers in the list

type Config 

type Config struct {
	// contains filtered or unexported fields
}

Config Carries configuration parameters for a context.

func LoadConfig 

func LoadConfig(uri string) (*Config, error)

LoadConfig reads a configuration from a given uri

func NewConfig 

func NewConfig() (*Config, error)

NewConfig alloc a new configuration

func (*Config) Cmp added in v0.12.0 

func (c *Config) Cmp(other *Config) bool

Cmp Compare two configs

func (*Config) Free 

func (c *Config) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Config) Get 

func (c *Config) Get(param string) (string, error)

Get Get a parameter from the configuration by key.

Example 
config, err := NewConfig()
if err != nil {
	// handle error
}

val, err := config.Get("sm.tile_cache_size")
if err != nil {
	// handle error
}
fmt.Println(val)

Output:

10000000

func (*Config) Iterate added in v0.10.3 

func (c *Config) Iterate(prefix string) (*ConfigIter, error)

Iterate configuration 

for iter, err := config.Iterate(); !iter.Done(); iter.Next(){
   param, value, err := iter.Here()
}

func (*Config) SaveToFile 

func (c *Config) SaveToFile(file string) error

SaveToFile Saves the config parameters to a (local) text file.

func (*Config) Set 

func (c *Config) Set(param string, value string) error

Set Sets a config parameter-value pair.

Example 
config, err := NewConfig()
if err != nil {
	// handle error
}

err = config.Set("sm.tile_cache_size", "10")
if err != nil {
	// handle error
}

val, err := config.Get("sm.tile_cache_size")
if err != nil {
	// handle error
}
fmt.Println(val)

Output:

10

func (*Config) Unset 

func (c *Config) Unset(param string) error

Unset Resets a config parameter to its default value.

type ConfigIter added in v0.10.3 

type ConfigIter struct {
	// contains filtered or unexported fields
}

ConfigIter Creates a config iterator object.

func NewConfigIter added in v0.10.3 

func NewConfigIter(config *Config, prefix string) (*ConfigIter, error)

NewConfigIter Creates an iterator for configuration. This can be used only for reading. This sets the pointer to the first search item.

func (*ConfigIter) Done added in v0.10.3 

func (ci *ConfigIter) Done() (bool, error)

Done Checks if the iterator is done.

func (*ConfigIter) Free added in v0.10.3 

func (ci *ConfigIter) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*ConfigIter) Here added in v0.10.3 

func (ci *ConfigIter) Here() (*string, *string, error)

Here Retrieves the param and value for the item currently pointed by the iterator

func (*ConfigIter) IsDone added in v0.10.3 

func (ci *ConfigIter) IsDone() bool

IsDone Checks if the iterator is done.

func (*ConfigIter) Next added in v0.10.3 

func (ci *ConfigIter) Next() error

Next Moves the iterator to the next item.

func (*ConfigIter) Reset added in v0.10.3 

func (ci *ConfigIter) Reset(prefix string) error

Reset a config iterator.

type Context 

type Context struct {
	// contains filtered or unexported fields
}

Context A TileDB context wraps a TileDB storage manager “instance.” Most objects and functions will require a Context. Internal error handling is also defined by the Context; the default error handler throws a TileDBError with a specific message.

func NewContext 

func NewContext(config *Config) (*Context, error)

NewContext creates a TileDB context with the given configuration If the configuration passed is null it is created with default config

Example

ExampleNewContext example of creating a new context 

// Create Context with default configuration:
context, err := NewContext(nil)
if err != nil {
	// handle error
	return
}

// Create a config and use it to create a new Context:
// (See ExampleConfig_Set for an example of setting config variables.)
config, err := NewConfig()
if err != nil {
	// handle error
	return
}
context, err = NewContext(config)
if err != nil {
	// handle error
	return
}

// Create a context directly from a configuration map:
context, err = NewContextFromMap(map[string]string{
	"sm.memory_budget":     "16GB",
	"sm.memory_budget_var": "32GB",
})
if err != nil {
	// handle error
	return
}

// Check if S3 is supported:
isS3Supported, err := context.IsSupportedFS(TILEDB_S3)
if err != nil {
	// handle error
	return
}

Output:

func NewContextFromMap added in v0.12.3 

func NewContextFromMap(cfgMap map[string]string) (*Context, error)

NewContextFromMap creates a TileDB context with the given configuration. If the configuration passed is nil, it is created with the default config. This is a shortcut for creating a *Config from the given map and using it to create a new context.

func (*Context) CancelAllTasks added in v0.14.2 

func (c *Context) CancelAllTasks() error

CancelAllTasks cancels all currently executing tasks on the context

func (*Context) Config 

func (c *Context) Config() (*Config, error)

Config retrieves a copy of the config from context

func (*Context) Free 

func (c *Context) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Context) IsSupportedFS 

func (c *Context) IsSupportedFS(fs FS) (bool, error)

IsSupportedFS Return true if the given filesystem backend is supported.

func (*Context) LastError 

func (c *Context) LastError() error

LastError returns the last error from this context

func (*Context) SetTag added in v0.8.0 

func (c *Context) SetTag(key string, value string) error

SetTag, sets context tag

func (*Context) Stats added in v0.12.1 

func (c *Context) Stats() ([]byte, error)

Stats gets stats for a context as json bytes

type Datatype 

type Datatype int8

Datatype 

const (
	// TILEDB_INT32 32-bit signed integer
	TILEDB_INT32 Datatype = C.TILEDB_INT32
	// TILEDB_INT64 64-bit signed integer
	TILEDB_INT64 Datatype = C.TILEDB_INT64
	// TILEDB_FLOAT32 32-bit floating point value
	TILEDB_FLOAT32 Datatype = C.TILEDB_FLOAT32
	// TILEDB_FLOAT64 64-bit floating point value
	TILEDB_FLOAT64 Datatype = C.TILEDB_FLOAT64
	// TILEDB_CHAR Character
	TILEDB_CHAR Datatype = C.TILEDB_CHAR
	// TILEDB_INT8 8-bit signed integer
	TILEDB_INT8 Datatype = C.TILEDB_INT8
	// TILEDB_UINT8 8-bit unsigned integer
	TILEDB_UINT8 Datatype = C.TILEDB_UINT8
	// TILEDB_INT16 16-bit signed integer
	TILEDB_INT16 Datatype = C.TILEDB_INT16
	// TILEDB_UINT16 16-bit unsigned integer
	TILEDB_UINT16 Datatype = C.TILEDB_UINT16
	// TILEDB_UINT32 32-bit unsigned integer
	TILEDB_UINT32 Datatype = C.TILEDB_UINT32
	// TILEDB_UINT64 64-bit unsigned integer
	TILEDB_UINT64 Datatype = C.TILEDB_UINT64
	// TILEDB_STRING_ASCII ASCII string
	TILEDB_STRING_ASCII Datatype = C.TILEDB_STRING_ASCII
	// TILEDB_STRING_UTF8 UTF-8 string
	TILEDB_STRING_UTF8 Datatype = C.TILEDB_STRING_UTF8
	// TILEDB_STRING_UTF16 UTF-16 string
	TILEDB_STRING_UTF16 Datatype = C.TILEDB_STRING_UTF16
	// TILEDB_STRING_UTF32 UTF-32 string
	TILEDB_STRING_UTF32 Datatype = C.TILEDB_STRING_UTF32
	// TILEDB_STRING_UCS2 UCS2 string
	TILEDB_STRING_UCS2 Datatype = C.TILEDB_STRING_UCS2
	// TILEDB_STRING_UCS4 UCS4 string
	TILEDB_STRING_UCS4 Datatype = C.TILEDB_STRING_UCS4
	// TILEDB_ANY This can be any datatype. Must store (type tag, value) pairs.
	TILEDB_ANY Datatype = C.TILEDB_ANY
	// TILEDB_DATETIME_YEAR 64-bit signed integer representing year
	TILEDB_DATETIME_YEAR Datatype = C.TILEDB_DATETIME_YEAR
	// TILEDB_DATETIME_MONTH 64-bit signed integer representing month
	TILEDB_DATETIME_MONTH Datatype = C.TILEDB_DATETIME_MONTH
	// TILEDB_DATETIME_WEEK 64-bit signed integer representing week
	TILEDB_DATETIME_WEEK Datatype = C.TILEDB_DATETIME_WEEK
	// TILEDB_DATETIME_DAY 64-bit signed integer representing day
	TILEDB_DATETIME_DAY Datatype = C.TILEDB_DATETIME_DAY
	// TILEDB_DATETIME_HR 64-bit signed integer representing hour
	TILEDB_DATETIME_HR Datatype = C.TILEDB_DATETIME_HR
	// TILEDB_DATETIME_MIN 64-bit signed integer representing minute
	TILEDB_DATETIME_MIN Datatype = C.TILEDB_DATETIME_MIN
	// TILEDB_DATETIME_SEC 64-bit signed integer representing second
	TILEDB_DATETIME_SEC Datatype = C.TILEDB_DATETIME_SEC
	// TILEDB_DATETIME_MS 64-bit signed integer representing ms
	TILEDB_DATETIME_MS Datatype = C.TILEDB_DATETIME_MS
	// TILEDB_DATETIME_US 64-bit signed integer representing us
	TILEDB_DATETIME_US Datatype = C.TILEDB_DATETIME_US
	// TILEDB_DATETIME_NS 64-bit signed integer representing ns
	TILEDB_DATETIME_NS Datatype = C.TILEDB_DATETIME_NS
	// TILEDB_DATETIME_PS 64-bit signed integer representing ps
	TILEDB_DATETIME_PS Datatype = C.TILEDB_DATETIME_PS
	// TILEDB_DATETIME_FS 64-bit signed integer representing fs
	TILEDB_DATETIME_FS Datatype = C.TILEDB_DATETIME_FS
	// TILEDB_DATETIME_AS 64-bit signed integer representing as
	TILEDB_DATETIME_AS Datatype = C.TILEDB_DATETIME_AS
	// TILEDB_TIME_HR 64-bit signed integer representing hour
	TILEDB_TIME_HR Datatype = C.TILEDB_TIME_HR
	// TILEDB_TIME_MIN 64-bit signed integer representing minute
	TILEDB_TIME_MIN Datatype = C.TILEDB_TIME_MIN
	// TILEDB_TIME_SEC 64-bit signed integer representing second
	TILEDB_TIME_SEC Datatype = C.TILEDB_TIME_SEC
	// TILEDB_TIME_MS 64-bit signed integer representing ms
	TILEDB_TIME_MS Datatype = C.TILEDB_TIME_MS
	// TILEDB_TIME_US 64-bit signed integer representing us
	TILEDB_TIME_US Datatype = C.TILEDB_TIME_US
	// TILEDB_TIME_NS 64-bit signed integer representing ns
	TILEDB_TIME_NS Datatype = C.TILEDB_TIME_NS
	// TILEDB_TIME_PS 64-bit signed integer representing ps
	TILEDB_TIME_PS Datatype = C.TILEDB_TIME_PS
	// TILEDB_TIME_FS 64-bit signed integer representing fs
	TILEDB_TIME_FS Datatype = C.TILEDB_TIME_FS
	// TILEDB_TIME_AS 64-bit signed integer representing as
	TILEDB_TIME_AS Datatype = C.TILEDB_TIME_AS
	// TILEDB_BLOB 8-bit unsigned integer (or std::byte)
	TILEDB_BLOB Datatype = C.TILEDB_BLOB
	// TILEDB_BOOL 8-bit boolean type
	TILEDB_BOOL Datatype = C.TILEDB_BOOL
)

func DatatypeFromString added in v0.8.4 

func DatatypeFromString(s string) (Datatype, error)

DatatypeFromString converts from a datatype string to enum

func (*Datatype) FromString added in v0.8.4 

func (d *Datatype) FromString(s string) error

FromString converts from a datatype string to enum

func (Datatype) GetValue added in v0.10.3 

func (d Datatype) GetValue(valueNum uint, cvalue unsafe.Pointer) (interface{}, error)

GetValue gets value stored in a void pointer for this data type

func (Datatype) MakeSlice added in v0.6.0 

func (d Datatype) MakeSlice(numElements uint64) (interface{}, unsafe.Pointer, error)

MakeSlice makes a slice of the correct type corresponding to the datatype, with a given number of elements

func (Datatype) MarshalJSON added in v0.8.4 

func (d Datatype) MarshalJSON() ([]byte, error)

MarshalJSON interface for marshaling to json

func (Datatype) ReflectKind 

func (d Datatype) ReflectKind() reflect.Kind

ReflectKind returns the reflect kind given a datatype

func (Datatype) Size added in v0.6.0 

func (d Datatype) Size() uint64

Size returns the datatype size in bytes

func (Datatype) String added in v0.8.4 

func (d Datatype) String() string

String returns string representation

func (*Datatype) UnmarshalJSON added in v0.8.4 

func (d *Datatype) UnmarshalJSON(bytes []byte) error

UnmarshalJSON interface for unmarshaling from json

type Dimension 

type Dimension struct {
	// contains filtered or unexported fields
}

Dimension Describes one dimension of an Array. The dimension consists of a type, lower and upper bound, and tile-extent describing the memory ordering. Dimensions are added to a Domain.

func NewDimension 

func NewDimension(context *Context, name string, datatype Datatype, domain interface{}, extent interface{}) (*Dimension, error)

NewDimension alloc a new dimension

Example 
// Create Config, this is optional
config, err := NewConfig()
if err != nil {
	// Handle error
	return
}

// Test context with config
context, err := NewContext(config)
if err != nil {
	// Handle error
	return
}

// Create Dimension
dim, err := NewDimension(context, "test", TILEDB_INT32, []int32{1, 10}, int32(5))
if err != nil {
	// Handle error
	return
}

// Set Filter List
filter, err := NewFilter(context, TILEDB_FILTER_GZIP)
if err != nil {
	// Handle error
	return
}

filterList, err := NewFilterList(context)
if err != nil {
	// Handle error
	return
}

err = filterList.AddFilter(filter)
if err != nil {
	// Handle error
	return
}

err = dim.SetFilterList(filterList)
if err != nil {
	// Handle error
	return
}

Output:

func NewStringDimension added in v0.9.0 

func NewStringDimension(context *Context, name string) (*Dimension, error)

NewStringDimension alloc a new string dimension

func (*Dimension) CellValNum added in v0.9.0 

func (d *Dimension) CellValNum() (uint32, error)

CellValNum returns number of values of one cell on this attribute. For variable-sized attributes returns TILEDB_VAR_NUM.

func (*Dimension) Context added in v0.14.2 

func (d *Dimension) Context() *Context

Context exposes the internal TileDB context used to initialize the dimension

func (*Dimension) Domain 

func (d *Dimension) Domain() (interface{}, error)

Domain returns the dimension's domain

func (*Dimension) Dump 

func (d *Dimension) Dump(path string) error

Dump Dumps the dimension in ASCII format in the selected output.

func (*Dimension) DumpSTDOUT 

func (d *Dimension) DumpSTDOUT() error

DumpSTDOUT Dumps the dimension in ASCII format to stdout

func (*Dimension) Extent 

func (d *Dimension) Extent() (interface{}, error)

Extent returns the dimension's extent

func (*Dimension) FilterList added in v0.10.3 

func (d *Dimension) FilterList() (*FilterList, error)

FilterList returns a copy of the filter list for attribute

func (*Dimension) Free 

func (d *Dimension) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Dimension) Name 

func (d *Dimension) Name() (string, error)

Name returns the name of the dimension

func (*Dimension) SetCellValNum added in v0.9.0 

func (d *Dimension) SetCellValNum(val uint32) error

SetCellValNum Sets the number of values per cell for a dimension. If this is not used, the default is `1`. This is inferred from the type parameter of the NewDimension function, but can also be set manually.

func (*Dimension) SetFilterList added in v0.10.3 

func (d *Dimension) SetFilterList(filterlist *FilterList) error

SetFilterList sets the dimension filterList

func (*Dimension) Type 

func (d *Dimension) Type() (Datatype, error)

Type returns the type of the dimension

type Domain 

type Domain struct {
	// contains filtered or unexported fields
}

Domain Represents the domain of an array. A Domain defines the set of Dimension objects for a given array. The properties of a Domain derive from the underlying dimensions. A Domain is a component of an ArraySchema.

func NewDomain 

func NewDomain(tdbCtx *Context) (*Domain, error)

NewDomain alloc a new domainuration

Example 
// Create Config, this is optional
config, err := NewConfig()
if err != nil {
	// Handle error
	return
}

// Test context with config
context, err := NewContext(config)
if err != nil {
	// Handle error
	return
}

// Create Dimension
dimension, err := NewDimension(context, "test", TILEDB_INT32, []int32{1, 10}, int32(5))
if err != nil {
	// Handle error
	return
}

// Create Domain
domain, err := NewDomain(context)
if err != nil {
	// Handle error
	return
}

// Add dimension to domain
err = domain.AddDimensions(dimension)
if err != nil {
	// Handle error
	return
}

Output:

func (*Domain) AddDimensions 

func (d *Domain) AddDimensions(dimensions ...*Dimension) error

AddDimensions adds one or more dimensions to a domain

func (*Domain) Context added in v0.14.2 

func (d *Domain) Context() *Context

Context exposes the internal TileDB context used to initialize the domain

func (*Domain) DimensionFromIndex 

func (d *Domain) DimensionFromIndex(index uint) (*Dimension, error)

DimensionFromIndex retrieves a dimension object from a domain by index.

func (*Domain) DimensionFromName 

func (d *Domain) DimensionFromName(name string) (*Dimension, error)

DimensionFromName retrieves a dimension object from a domain by name (key)

func (*Domain) Dump 

func (d *Domain) Dump(path string) error

Dump Dumps the domain in ASCII format in the selected output.

func (*Domain) DumpSTDOUT 

func (d *Domain) DumpSTDOUT() error

DumpSTDOUT Dumps the domain in ASCII format to stdout

func (*Domain) Free 

func (d *Domain) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Domain) HasDimension added in v0.9.0 

func (d *Domain) HasDimension(dimName string) (bool, error)

HasDimension returns true if dimension: `dimName` is part of the domain

func (*Domain) NDim 

func (d *Domain) NDim() (uint, error)

NDim returns the number of dimensions

func (*Domain) Type 

func (d *Domain) Type() (Datatype, error)

Type returns a domains type deduced from dimensions

type EncryptionType added in v0.2.0 

type EncryptionType uint8

EncryptionType represents different encryption algorithms 

const (
	// TILEDB_NO_ENCRYPTION No encryption
	TILEDB_NO_ENCRYPTION EncryptionType = C.TILEDB_NO_ENCRYPTION
	// TILEDB_AES_256_GCM AES-256-GCM encryption
	TILEDB_AES_256_GCM EncryptionType = C.TILEDB_AES_256_GCM
)

func (EncryptionType) String added in v0.14.0 

func (encryptionType EncryptionType) String() string

String returns string representation

type FS 

type FS int8

FS represents support fs types 

const (
	// TILEDB_HDFS HDFS filesystem support
	TILEDB_HDFS FS = C.TILEDB_HDFS

	// TILEDB_S3 S3 filesystem support
	TILEDB_S3 FS = C.TILEDB_S3
)

type FileStoreMimeType added in v0.16.2 

type FileStoreMimeType uint32

FileStoreMimeType is an enum for TileDB filestore mime types

type Filter added in v0.2.0 

type Filter struct {
	// contains filtered or unexported fields
}

Filter represents

func NewFilter added in v0.2.0 

func NewFilter(context *Context, filterType FilterType) (*Filter, error)

NewFilter Allocs a new filter

func (*Filter) Context added in v0.14.2 

func (f *Filter) Context() *Context

Context exposes the internal TileDB context used to initialize the filter

func (*Filter) Free added in v0.2.0 

func (f *Filter) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Filter) Option added in v0.2.0 

func (f *Filter) Option(filterOption FilterOption) (interface{}, error)

Option fetchs the specified option set on a filter. Returns an interface{} dependent on the option being fetched var optionValue int32 optionValueInterface, err := filter.Option(TILEDB_FILTER_GZIP) optionValue = optionValueInterface.(int32)

func (*Filter) SetOption added in v0.2.0 

func (f *Filter) SetOption(filterOption FilterOption, valueInterface interface{}) error

SetOption set an option on a filter. Options are filter dependent; this function returns an error if the given option is not valid for the given filter.

func (*Filter) Type added in v0.2.0 

func (f *Filter) Type() (FilterType, error)

Type returns the filter type

type FilterList added in v0.2.0 

type FilterList struct {
	// contains filtered or unexported fields
}

FilterList represents

func NewFilterList added in v0.2.0 

func NewFilterList(context *Context) (*FilterList, error)

Alloc a new FilterList

func (*FilterList) AddFilter added in v0.2.0 

func (f *FilterList) AddFilter(filter *Filter) error

AddFilter appends a filter to a filter list. Data is processed through each filter in the order the filters were added.

func (*FilterList) Context added in v0.14.2 

func (f *FilterList) Context() *Context

Context exposes the internal TileDB context used to initialize the filter list

func (*FilterList) FilterFromIndex added in v0.2.0 

func (f *FilterList) FilterFromIndex(index uint32) (*Filter, error)

FilterFromIndex Retrieves a filter object from a filter list by index.

func (*FilterList) Filters added in v0.2.0 

func (f *FilterList) Filters() ([]*Filter, error)

Filters return slice of filters applied to filter list

func (*FilterList) Free added in v0.2.0 

func (f *FilterList) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*FilterList) MaxChunkSize added in v0.2.0 

func (f *FilterList) MaxChunkSize() (uint32, error)

MaxChunkSize Gets the maximum tile chunk size for a filter list.

func (*FilterList) NFilters added in v0.2.0 

func (f *FilterList) NFilters() (uint32, error)

NFilters Retrieves the number of filters in a filter list.

func (*FilterList) SetMaxChunkSize added in v0.2.0 

func (f *FilterList) SetMaxChunkSize(maxChunkSize uint32) error

SetMaxChunkSize sets the maximum tile chunk size for a filter list.

type FilterOption added in v0.2.0 

type FilterOption uint8

FilterOption for a given filter 

const (
	// TILEDB_COMPRESSION_LEVEL Compression level. Type: `int32_t`.
	TILEDB_COMPRESSION_LEVEL FilterOption = C.TILEDB_COMPRESSION_LEVEL
	// TILEDB_BIT_WIDTH_MAX_WINDOW Max window length for bit width reduction. Type: `uint32_t`.
	TILEDB_BIT_WIDTH_MAX_WINDOW FilterOption = C.TILEDB_BIT_WIDTH_MAX_WINDOW
	// TILEDB_POSITIVE_DELTA_MAX_WINDOW Max window length for positive-delta encoding. Type: `uint32_t`.
	TILEDB_POSITIVE_DELTA_MAX_WINDOW FilterOption = C.TILEDB_POSITIVE_DELTA_MAX_WINDOW
)

type FilterType added in v0.2.0 

type FilterType uint8

FilterType for attribute/coordinates/offsets filters 

const (
	// TILEDB_FILTER_NONE No-op filter
	TILEDB_FILTER_NONE FilterType = C.TILEDB_FILTER_NONE
	// TILEDB_FILTER_GZIP Gzip compressor
	TILEDB_FILTER_GZIP FilterType = C.TILEDB_FILTER_GZIP
	// TILEDB_FILTER_ZSTD Zstandard compressor
	TILEDB_FILTER_ZSTD FilterType = C.TILEDB_FILTER_ZSTD
	// TILEDB_FILTER_LZ4 LZ4 compressor
	TILEDB_FILTER_LZ4 FilterType = C.TILEDB_FILTER_LZ4
	// TILEDB_FILTER_RLE Run-length encoding compressor
	TILEDB_FILTER_RLE FilterType = C.TILEDB_FILTER_RLE
	// TILEDB_FILTER_BZIP2 Bzip2 compressor
	TILEDB_FILTER_BZIP2 FilterType = C.TILEDB_FILTER_BZIP2
	// TILEDB_FILTER_DOUBLE_DELTA Double-delta compressor
	TILEDB_FILTER_DOUBLE_DELTA FilterType = C.TILEDB_FILTER_DOUBLE_DELTA
	// TILEDB_FILTER_BIT_WIDTH_REDUCTION Bit width reduction filter.
	TILEDB_FILTER_BIT_WIDTH_REDUCTION FilterType = C.TILEDB_FILTER_BIT_WIDTH_REDUCTION
	// TILEDB_FILTER_BITSHUFFLE Bitshuffle filter.
	TILEDB_FILTER_BITSHUFFLE FilterType = C.TILEDB_FILTER_BITSHUFFLE
	// TILEDB_FILTER_BYTESHUFFLE Byteshuffle filter.
	TILEDB_FILTER_BYTESHUFFLE FilterType = C.TILEDB_FILTER_BYTESHUFFLE
	// TILEDB_FILTER_POSITIVE_DELTA Positive-delta encoding filter.
	TILEDB_FILTER_POSITIVE_DELTA FilterType = C.TILEDB_FILTER_POSITIVE_DELTA
	// TILEDB_FILTER_SCALE_FLOAT FILTER_SCALE_FLOAT float scaling filter.
	TILEDB_FILTER_SCALE_FLOAT FilterType = C.TILEDB_FILTER_SCALE_FLOAT
)

type FolderData added in v0.14.4 

type FolderData struct {
	Folders []string
	Files   []string
	Vfs     *VFS
}

FolderData is a type encapsulating list of folders and files

type FragmentInfo added in v0.11.0 

type FragmentInfo struct {
	// contains filtered or unexported fields
}

FragmentInfo struct representing a TileDB fragment info object.

A FragmentInfo object contains information about fragnents of an array that can be queried using methods taht have receiver type of *FragmentInfo

func NewFragmentInfo added in v0.11.0 

func NewFragmentInfo(tdbCtx *Context, uri string) (*FragmentInfo, error)

NewFragmentInfo alloc a new fragment info for a given array and fetches all the fragment information for that array.

func (*FragmentInfo) Context added in v0.14.2 

func (fI *FragmentInfo) Context() *Context

Context exposes the internal TileDB context used to initialize the fragment info

func (*FragmentInfo) DumpSTDOUT added in v0.11.0 

func (fI *FragmentInfo) DumpSTDOUT() error

DumpSTDOUT dumps the fragment info in ASCII format in the selected output.

func (*FragmentInfo) Free added in v0.11.0 

func (fI *FragmentInfo) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*FragmentInfo) GetCellNum added in v0.11.0 

func (fI *FragmentInfo) GetCellNum(fid uint32) (uint64, error)

GetCellNum retrieves the number of cells written to the fragment by the user. In the case of sparse fragments, this is the number of non-empty cells in the fragment. In the case of dense fragments, TileDB may add fill values to populate partially populated tiles. Those fill values are counted in the returned number of cells. In other words, the cell number is derived from the number of *integral* tiles written in the file.

func (*FragmentInfo) GetDense added in v0.11.0 

func (fI *FragmentInfo) GetDense(fid uint32) (bool, error)

GetDense checks if a fragment is dense.

func (*FragmentInfo) GetFragmentNum added in v0.11.0 

func (fI *FragmentInfo) GetFragmentNum() (uint32, error)

GetFragmentNum gets the number of fragments.

func (*FragmentInfo) GetFragmentSize added in v0.11.0 

func (fI *FragmentInfo) GetFragmentSize(fid uint32) (uint64, error)

GetFragmentSize gets the fragment size in bytes.

func (*FragmentInfo) GetFragmentURI added in v0.11.0 

func (fI *FragmentInfo) GetFragmentURI(fid uint32) (string, error)

GetFragmentURI gets a fragment URI. fid is the index of the fragment of interest.

func (*FragmentInfo) GetNonEmptyDomainFromIndex added in v0.11.0 

func (fI *FragmentInfo) GetNonEmptyDomainFromIndex(fid uint32, did uint32) (*NonEmptyDomain, error)

GetNonEmptyDomainFromIndex retrieves the non-empty domain from a given fragment for a given dimension index. func (fI *FragmentInfo) GetNonEmptyDomainFromIndex

func (*FragmentInfo) GetNonEmptyDomainFromName added in v0.11.0 

func (fI *FragmentInfo) GetNonEmptyDomainFromName(fid uint32, did string) (*NonEmptyDomain, error)

GetNonEmptyDomainFromName retrieves the non-empty domain from a given fragment for a given dimension name. func (fI *FragmentInfo) GetNonEmptyDomainFromName

func (*FragmentInfo) GetNonEmptyDomainVarFromIndex added in v0.11.0 

func (fI *FragmentInfo) GetNonEmptyDomainVarFromIndex(fid uint32, did uint32) (*NonEmptyDomain, error)

GetNonEmptyDomainVarFromIndex retrieves the non-empty domain from a fragment for a given dimension index. Applicable to var-sized dimensions.

func (*FragmentInfo) GetNonEmptyDomainVarFromName added in v0.11.0 

func (fI *FragmentInfo) GetNonEmptyDomainVarFromName(fid uint32, did string) (*NonEmptyDomain, error)

GetNonEmptyDomainVarFromName retrieves the non-empty domain from a fragment for a given dimension name. Applicable to var-sized dimensions.

func (*FragmentInfo) GetNonEmptyDomainVarSizeFromIndex added in v0.11.0 

func (fI *FragmentInfo) GetNonEmptyDomainVarSizeFromIndex(fid uint32, did uint32) (
	uint64, uint64, error)

GetNonEmptyDomainVarSizeFromIndex retrieves the non-empty domain range sizes from a fragment for a given dimension index. Applicable to var-sized dimensions. func (fI *FragmentInfo) GetNonEmptyDomainVarSizeFromName

func (*FragmentInfo) GetNonEmptyDomainVarSizeFromName added in v0.11.0 

func (fI *FragmentInfo) GetNonEmptyDomainVarSizeFromName(fid uint32, did string) (
	uint64, uint64, error)

GetNonEmptyDomainVarSizeFromName retrieves the non-empty domain range sizes from a fragment for a given dimension name. Applicable to var-sized dimensions.

func (*FragmentInfo) GetSparse added in v0.11.0 

func (fI *FragmentInfo) GetSparse(fid uint32) (bool, error)

GetSparse checks if a fragment is sparse.

func (*FragmentInfo) GetTimestampRange added in v0.11.0 

func (fI *FragmentInfo) GetTimestampRange(fid uint32) (uint64, uint64, error)

GetTimestampRange gets the timestamp range of a fragment.

func (*FragmentInfo) GetToVacuumNum added in v0.11.0 

func (fI *FragmentInfo) GetToVacuumNum() (uint32, error)

GetToVacuumNum gets the number of fragments to vacuum.

func (*FragmentInfo) GetToVacuumURI added in v0.11.0 

func (fI *FragmentInfo) GetToVacuumURI(fid uint32) (string, error)

GetToVacuumURI gets the URI of the fragment to vacuum with the given index. fid is the index of the fragment of interest.

func (*FragmentInfo) GetUnconsolidatedMetadataNum added in v0.11.0 

func (fI *FragmentInfo) GetUnconsolidatedMetadataNum() (uint32, error)

GetUnconsolidatedMetadataNum gets the number of fragments with unconsolidated metadata. func (fI *FragmentInfo) GetUnconsolidatedMetadataNum

func (*FragmentInfo) GetVersion added in v0.11.0 

func (fI *FragmentInfo) GetVersion(fid uint32) (uint32, error)

GetVersion retrieves the format version of a fragment.

func (*FragmentInfo) HasConsolidatedMetadata added in v0.11.0 

func (fI *FragmentInfo) HasConsolidatedMetadata(fid uint32) (bool, error)

HasConsolidatedMetadata checks if a fragment has consolidated metadata.

func (*FragmentInfo) Load added in v0.11.0 

func (fI *FragmentInfo) Load() error

Load loads the fragment info.

type Freeable added in v0.16.3 

type Freeable interface {
	Free() // Releases non–garbage-collected resources held by this object.
}

Freeable represents an object that can be Free'd at the end of its lifetime to release its resources.

type Layout 

type Layout int8

Layout cell/tile layout 

const (
	// TILEDB_ROW_MAJOR Row-major layout
	TILEDB_ROW_MAJOR Layout = C.TILEDB_ROW_MAJOR
	// TILEDB_COL_MAJOR Column-major layout
	TILEDB_COL_MAJOR Layout = C.TILEDB_COL_MAJOR
	// TILEDB_GLOBAL_ORDER Global-order layout
	TILEDB_GLOBAL_ORDER Layout = C.TILEDB_GLOBAL_ORDER
	// TILEDB_UNORDERED Unordered layout
	TILEDB_UNORDERED Layout = C.TILEDB_UNORDERED
	// TILEDB_HILBERT Hilbert layout
	TILEDB_HILBERT Layout = C.TILEDB_HILBERT
)

type NonEmptyDomain added in v0.4.0 

type NonEmptyDomain struct {
	DimensionName string
	Bounds        interface{}
}

NonEmptyDomain contains the non empty dimension bounds and dimension name

func DeserializeArrayNonEmptyDomain added in v0.6.0 

func DeserializeArrayNonEmptyDomain(a *Array, buffer *Buffer, serializationType SerializationType) ([]NonEmptyDomain, bool, error)

DeserializeArrayNonEmptyDomain deserializes an array nonempty domain

type NumOfFragmentsData added in v0.10.0 

type NumOfFragmentsData struct {
	NumOfFolders int
	Vfs          *VFS
}

NumOfFragmentsData is a type

type ObjectList added in v0.10.3 

type ObjectList struct {
	// contains filtered or unexported fields
}

ObjectList defines the value of data returned by object iteration callback

func ObjectLs added in v0.10.3 

func ObjectLs(tdbCtx *Context, path string) (*ObjectList, error)

ObjectLs is similar to `tiledb_walk`, but now the function visits only the children of `path` (it does not recursively continue to the children directories).

func ObjectWalk added in v0.10.3 

func ObjectWalk(tdbCtx *Context, path string, walkOrder WalkOrder) (*ObjectList, error)

ObjectWalk (iterates) over the TileDB objects contained in *path*. The traversal is done recursively in the order defined by the user. The user provides a callback function which is applied on each of the visited TileDB objects. The iteration continues for as long the callback returns non-zero, and stops when the callback returns 0. Note that this function ignores any object (e.g., file or directory) that is not TileDB-related.

type ObjectTypeEnum added in v0.10.3 

type ObjectTypeEnum int8

ObjectTypeEnum 

const (
	// Invalid object
	TILEDB_INVALID ObjectTypeEnum = C.TILEDB_INVALID
	// Group object
	TILEDB_GROUP ObjectTypeEnum = C.TILEDB_GROUP
	// Array object
	TILEDB_ARRAY ObjectTypeEnum = C.TILEDB_ARRAY
)

func ObjectType added in v0.10.3 

func ObjectType(tdbCtx *Context, path string) (ObjectTypeEnum, error)

ObjectType returns the object type A TileDB "object" is currently either a TileDB array or a TileDB group.

func ObjectTypeFromString added in v0.15.0 

func ObjectTypeFromString(s string) (ObjectTypeEnum, error)

ObjectTypeFromString returns the internal representation of the object type

func (ObjectTypeEnum) String added in v0.15.0 

func (o ObjectTypeEnum) String() string

String returns string representation

type Query 

type Query struct {
	// contains filtered or unexported fields
}

Query construct and execute read/write queries on a tiledb Array

func NewQuery 

func NewQuery(tdbCtx *Context, array *Array) (*Query, error)

NewQuery Creates a TileDB query object.

The query type (read or write) must be the same as the type used to open the array object.

The storage manager also acquires a shared lock on the array. This means multiple read and write queries to the same array can be made concurrently (in TileDB, only consolidation requires an exclusive lock for a short period of time).

Example

ExampleNewQuery shows a complete write and read example 

// Create configuration
config, err := NewConfig()
if err != nil {
	// Handle error
	return
}

// Test context with config
context, err := NewContext(config)
if err != nil {
	// Handle error
	return
}

// Test create dimension
dimension, err := NewDimension(context, "dim1", TILEDB_INT8, []int8{0, 9}, int8(10))
if err != nil {
	// Handle error
	return
}

// Test creating domain
domain, err := NewDomain(context)
if err != nil {
	// Handle error
	return
}

// Add dimension
err = domain.AddDimensions(dimension)
if err != nil {
	// Handle error
	return
}

// Create array schema
arraySchema, err := NewArraySchema(context, TILEDB_DENSE)
if err != nil {
	// Handle error
	return
}

// Crete attribute to add to schema
attribute, err := NewAttribute(context, "a1", TILEDB_INT32)
if err != nil {
	// Handle error
	return
}

// Crete attribute to add to schema
attribute2, err := NewAttribute(context, "a2", TILEDB_STRING_ASCII)
if err != nil {
	// Handle error
	return
}

// Crete attribute to add to schema
attribute3, err := NewAttribute(context, "a3", TILEDB_FLOAT32)
if err != nil {
	// Handle error
	return
}

// Crete attribute to add to schema
attribute4, err := NewAttribute(context, "a4", TILEDB_STRING_UTF8)
if err != nil {
	// Handle error
	return
}

// Set a3 to be variable length
err = attribute3.SetCellValNum(TILEDB_VAR_NUM)
if err != nil {
	// Handle error
	return
}

// Set a4 to be variable length
err = attribute4.SetCellValNum(TILEDB_VAR_NUM)
if err != nil {
	// Handle error
	return
}

// Add Attribute
err = arraySchema.AddAttributes(attribute, attribute2, attribute3, attribute4)
if err != nil {
	// Handle error
	return
}

// Set Domain
err = arraySchema.SetDomain(domain)
if err != nil {
	// Handle error
	return
}

// Validate Schema
err = arraySchema.Check()
if err != nil {
	// Handle error
	return
}

// create temp array name and path
// normal usage would be "my_array" uri
// Temp path is used here so unit test can clean up after itself
tmpArrayPath, err := os.MkdirTemp("", "tiledb_test_array")
if err != nil {
	// Handle error
	return
}
defer os.RemoveAll(tmpArrayPath)
// Create new array struct
array, err := NewArray(context, tmpArrayPath)
if err != nil {
	// Handle error
	return
}

// Create array on disk
err = array.Create(arraySchema)
if err != nil {
	// Handle error
	return
}

// Open array for writting
err = array.Open(TILEDB_WRITE)
if err != nil {
	// Handle error
	return
}

// Create write query
query, err := NewQuery(context, array)
if err != nil {
	// Handle error
	return
}

// Limit writting to subarray
err = query.SetSubArray([]int8{0, 1})
if err != nil {
	// Handle error
	return
}

// Set write layout
err = query.SetLayout(TILEDB_ROW_MAJOR)
if err != nil {
	// Handle error
	return
}

// Create write buffers
bufferA1 := []int32{1, 2}
_, err = query.SetBuffer("a1", bufferA1)
if err != nil {
	// Handle error
	return
}

bufferA2 := []byte("ab")
_, err = query.SetBuffer("a2", bufferA2)
if err != nil {
	// Handle error
	return
}

bufferA3 := []float32{1.0, 2.0, 3.0, 4.0, 5.0}
offsetBufferA3 := []uint64{0, 3}
_, _, err = query.SetBufferVar("a3", offsetBufferA3, bufferA3)
if err != nil {
	// Handle error
	return
}

bufferA4 := []byte("hello" + "world")
offsetBufferA4 := []uint64{0, 5}
_, _, err = query.SetBufferVar("a4", offsetBufferA4, bufferA4)
if err != nil {
	// Handle error
	return
}

err = query.Submit()
if err != nil {
	// Handle error
	return
}

// Validate status, since query was used this is should be complete
status, err := query.Status()
if err != nil {
	// Handle error
	return
}
if status != TILEDB_COMPLETED {
	// handle non-complete query
	// If applicable read partial data in buffer
	// and re-submit for remaining results
}

// Finalize Write
err = query.Finalize()
if err != nil {
	// Handle error
	return
}

// Close and prepare to read
err = array.Close()
if err != nil {
	// Handle error
	return
}

// Reopen array for reading
err = array.Open(TILEDB_READ)
if err != nil {
	// Handle error
	return
}

// Create query for reading
query, err = NewQuery(context, array)
if err != nil {
	// Handle error
	return
}

// Set read subarray to only data that was written
err = query.SetSubArray([]int8{0, 1})
if err != nil {
	// Handle error
	return
}

// Set empty buffers for reading
readBufferA1 := make([]int32, 2)
_, err = query.SetBuffer("a1", readBufferA1)
if err != nil {
	// Handle error
	return
}

readBufferA2 := make([]byte, 2)
_, err = query.SetBuffer("a2", readBufferA2)
if err != nil {
	// Handle error
	return
}

readBufferA3 := make([]float32, 5)
readOffsetBufferA3 := make([]uint64, 2)
_, _, err = query.SetBufferVar("a3", readOffsetBufferA3, readBufferA3)
if err != nil {
	// Handle error
	return
}
readBufferA4 := make([]byte, 10)
readOffsetBufferA4 := make([]uint64, 2)
_, _, err = query.SetBufferVar("a4", readOffsetBufferA4, readBufferA4)
if err != nil {
	// Handle error
	return
}
// Set read layout
err = query.SetLayout(TILEDB_ROW_MAJOR)
if err != nil {
	// Handle error
	return
}
// Submit read query async
// Async submits do not block
err = query.SubmitAsync()
if err != nil {
	// Handle error
	return
}
// Wait for status to return complete or to error
// Loop while status is inprogress
for status, err = query.Status(); status == TILEDB_INPROGRESS && err == nil; status, err = query.Status() {
	// Do something while query is running
}
if err != nil {
	// Handle error
	return
}

// Results should be returned
hasResults, err := query.HasResults()
if err != nil {
	// Handle error
	return
}
if hasResults {
	// Do something with read buffer
}

stats, err := query.Stats()
if err != nil {
	// Handle error
	return
}

if len(stats) > 0 {
	// Do something with stats
}

Output:

func (*Query) AddRange added in v0.7.0 

func (q *Query) AddRange(dimIdx uint32, start interface{}, end interface{}) error

AddRange adds a 1D range along a subarray dimension, which is in the form (start, end, stride). The datatype of the range components must be the same as the type of the domain of the array in the query. The stride is currently unsupported and set to nil.

func (*Query) AddRangeByName added in v0.11.5 

func (q *Query) AddRangeByName(dimName string, start interface{}, end interface{}) error

AddRangeByName adds a 1D range along a subarray dimension, which is in the form (start, end, stride). The datatype of the range components must be the same as the type of the domain of the array in the query. The stride is currently unsupported and set to nil.

func (*Query) AddRangeVar added in v0.9.0 

func (q *Query) AddRangeVar(dimIdx uint32, start interface{}, end interface{}) error

AddRangeVar adds a range applicable to variable-sized dimensions Applicable only to string dimensions

func (*Query) AddRangeVarByName added in v0.11.5 

func (q *Query) AddRangeVarByName(dimName string, start interface{}, end interface{}) error

AddRangeVarByName adds a range applicable to variable-sized dimensions Applicable only to string dimensions

func (*Query) Array added in v0.10.3 

func (q *Query) Array() (*Array, error)

Array returns array used by query

func (*Query) Buffer added in v0.2.0 

func (q *Query) Buffer(attributeOrDimension string) (interface{}, error)

Buffer returns a slice backed by the underlying c buffer from tiledb

func (*Query) BufferNullable added in v0.11.4 

func (q *Query) BufferNullable(attributeOrDimension string) (interface{}, []uint8, error)

BufferNullable returns a slice backed by the underlying c buffer from tiledb for validities, and values

func (*Query) BufferSize added in v0.6.0 

func (q *Query) BufferSize(attributeNameOrDimension string) (uint64, error)

BufferSize returns the size (in num elements) of the backing C buffer for the given attribute

func (*Query) BufferSizeNullable added in v0.11.1 

func (q *Query) BufferSizeNullable(attributeName string) (uint64, uint64, error)

BufferSizeNullable returns the size (in num elements) of the backing C buffer for the given nullable attribute

func (*Query) BufferSizeVar added in v0.6.0 

func (q *Query) BufferSizeVar(attributeOrDimension string) (uint64, uint64, error)

BufferSizeVar returns the size (in num elements) of the backing C buffers for the given variable-length attribute

func (*Query) BufferSizeVarNullable added in v0.11.1 

func (q *Query) BufferSizeVarNullable(attributeName string) (uint64, uint64, uint64, error)

BufferSizeVarNullable returns the size (in num elements) of the backing C buffers for the given variable-length nullable attribute

func (*Query) BufferVar added in v0.2.0 

func (q *Query) BufferVar(attributeOrDimension string) ([]uint64, interface{}, error)

BufferVar returns a slice backed by the underlying c buffer from tiledb for offets and values

func (*Query) BufferVarNullable added in v0.11.4 

func (q *Query) BufferVarNullable(attributeOrDimension string) ([]uint64, interface{}, []uint8, error)

BufferVarNullable returns a slice backed by the underlying c buffer from tiledb for offets, validities, and values

func (*Query) Config added in v0.12.0 

func (q *Query) Config() (*Config, error)

Config get config on query

func (*Query) Context added in v0.14.2 

func (q *Query) Context() *Context

Context exposes the internal TileDB context used to initialize the query

func (*Query) EstResultSize added in v0.9.1 

func (q *Query) EstResultSize(attributeName string) (*uint64, error)

EstResultSize gets the query estimated result size in bytes for an attribute

func (*Query) EstResultSizeNullable added in v0.11.0 

func (q *Query) EstResultSizeNullable(attributeName string) (*uint64, *uint64, error)

EstResultSizeNullable gets the query estimated result size in bytes for an attribute

func (*Query) EstResultSizeVar added in v0.9.1 

func (q *Query) EstResultSizeVar(attributeName string) (*uint64, *uint64, error)

EstResultSizeVar gets the query estimated result size in bytes for a var sized attribute

func (*Query) EstResultSizeVarNullable added in v0.11.0 

func (q *Query) EstResultSizeVarNullable(attributeName string) (*uint64, *uint64, *uint64, error)

EstResultSizeVarNullable gets the query estimated result size in bytes for a var sized attribute

func (*Query) EstimateBufferElements added in v0.10.0 

func (q *Query) EstimateBufferElements() (map[string][3]uint64, error)

EstimateBufferElements compute an upper bound on the buffer elements needed to read a subarray or range(s) Returns a map of attribute or dimension name to the maximum number of elements that can be read in the given subarray. For each attribute, a pair of numbers are returned. The first, for variable-length attributes, is the maximum number of offsets for that attribute in the given subarray. For fixed-length attributes and coordinates, the first is always 0. The second is the maximum number of elements for that attribute in the given subarray.

func (*Query) Finalize 

func (q *Query) Finalize() error

Finalize Flushes all internal state of a query object and finalizes the query. This is applicable only to global layout writes. It has no effect for any other query type.

func (*Query) Free 

func (q *Query) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*Query) GetFragmentNum added in v0.9.1 

func (q *Query) GetFragmentNum() (*uint32, error)

GetFragmentNum returns num of fragments

func (*Query) GetFragmentTimestampRange added in v0.9.1 

func (q *Query) GetFragmentTimestampRange(num uint64) (*uint64, *uint64, error)

GetFragmentTimestampRange returns timestamp range for a fragment

func (*Query) GetFragmentURI added in v0.9.1 

func (q *Query) GetFragmentURI(num uint64) (*string, error)

GetFragmentURI returns uri for a fragment

func (*Query) GetRange added in v0.7.0 

func (q *Query) GetRange(dimIdx uint32, rangeNum uint64) (interface{}, interface{}, error)

GetRange retrieves a specific range of the query subarray along a given dimension. Returns (start, end, error) If start size or end size is 0 returns nil, nil, nil Stride is not supported at the moment, always nil

func (*Query) GetRangeFromName added in v0.11.5 

func (q *Query) GetRangeFromName(dimName string, rangeNum uint64) (interface{}, interface{}, error)

GetRangeFromName retrieves a specific range of the query subarray along a given dimension. Returns (start, end, error) If start size or end size is 0 returns nil, nil, nil Stride is not supported at the moment, always nil

func (*Query) GetRangeNum added in v0.7.0 

func (q *Query) GetRangeNum(dimIdx uint32) (*uint64, error)

GetRangeNum retrieves the number of ranges of the query subarray along a given dimension.

func (*Query) GetRangeNumFromName added in v0.11.5 

func (q *Query) GetRangeNumFromName(dimName string) (*uint64, error)

GetRangeNumFromName retrieves the number of ranges of the query subarray along a given dimension.

func (*Query) GetRangeVar added in v0.9.0 

func (q *Query) GetRangeVar(dimIdx uint32, rangeNum uint64) (interface{}, interface{}, error)

GetRangeVar exists for continuinity with other TileDB APIs GetRange in Golang supports the variable length attribute also The function retrieves a specific range of the query subarray along a given dimension. Returns (start, end, error)

func (*Query) GetRangeVarFromName added in v0.11.5 

func (q *Query) GetRangeVarFromName(dimName string, rangeNum uint64) (interface{}, interface{}, error)

GetRangeVarFromName exists for continuinity with other TileDB APIs GetRange in Golang supports the variable length attribute also The function retrieves a specific range of the query subarray along a given dimension. Returns (start, end, error)

func (*Query) GetRanges added in v0.7.1 

func (q *Query) GetRanges() (map[string][]RangeLimits, error)

GetRanges gets the number of dimensions from the array under current query and builds an array of dimensions that have as memmbers arrays of ranges

func (*Query) HasResults 

func (q *Query) HasResults() (bool, error)

HasResults Returns true if the query has results Applicable only to read queries (it returns false for write queries)

func (*Query) ResultBufferElements added in v0.5.0 

func (q *Query) ResultBufferElements() (map[string][3]uint64, error)

ResultBufferElements returns the number of elements in the result buffers from a read query. This is a map from the attribute name to a pair of values. The first is number of elements (offsets) for var size attributes, and the second is number of elements in the data buffer. For fixed sized attributes (and coordinates), the first is always 0.

func (*Query) SetBuffer 

func (q *Query) SetBuffer(attributeOrDimension string, buffer interface{}) (*uint64,
	error)

SetBuffer Sets the buffer for a fixed-sized attribute to a query The buffer must be an initialized slice

func (*Query) SetBufferNullable added in v0.11.0 

func (q *Query) SetBufferNullable(attributeOrDimension string, buffer interface{}, bufferValidity []uint8) (*uint64, *uint64, error)

SetBufferNullable Sets the buffer for a fixed-sized nullable attribute to a query The buffer must be an initialized slice

func (*Query) SetBufferNullableUnsafe added in v0.11.0 

func (q *Query) SetBufferNullableUnsafe(attribute string, buffer unsafe.Pointer, bufferSize uint64, bufferValidity unsafe.Pointer, bufferValiditySize uint64) (*uint64, *uint64, error)

SetBufferNullableUnsafe Sets the buffer for a fixed-sized nullable attribute to a query This takes an unsafe pointer which is passsed straight to tiledb c_api for advanced usage

func (*Query) SetBufferUnsafe added in v0.8.4 

func (q *Query) SetBufferUnsafe(attribute string, buffer unsafe.Pointer, bufferSize uint64) (*uint64, error)

SetBufferUnsafe Sets the buffer for a fixed-sized attribute to a query This takes an unsafe pointer which is passsed straight to tiledb c_api for advanced usage

func (*Query) SetBufferVar 

func (q *Query) SetBufferVar(attributeOrDimension string, offset []uint64, buffer interface{}) (*uint64, *uint64, error)

SetBufferVar Sets the buffer for a variable sized attribute/dimension to a query The buffer must be an initialized slice

func (*Query) SetBufferVarNullable added in v0.11.0 

func (q *Query) SetBufferVarNullable(attributeOrDimension string, offset []uint64, buffer interface{}, bufferValidity []uint8) (*uint64, *uint64, *uint64, error)

SetBufferVarNullable Sets the buffer for a variable sized nullable attribute/dimension to a query The buffer must be an initialized slice

func (*Query) SetBufferVarNullableUnsafe added in v0.11.0 

func (q *Query) SetBufferVarNullableUnsafe(attribute string, offset unsafe.Pointer, offsetSize uint64, buffer unsafe.Pointer, bufferSize uint64, bufferValidity unsafe.Pointer, bufferValiditySize uint64) (*uint64, *uint64, *uint64, error)

SetBufferVarNullableUnsafe Sets the buffer for a variable sized nullable attribute to a query This takes unsafe pointers which is passsed straight to tiledb c_api for advanced usage

func (*Query) SetBufferVarUnsafe added in v0.8.4 

func (q *Query) SetBufferVarUnsafe(attribute string, offset unsafe.Pointer, offsetSize uint64, buffer unsafe.Pointer, bufferSize uint64) (*uint64, *uint64, error)

SetBufferVarUnsafe Sets the buffer for a variable sized attribute to a query This takes unsafe pointers which is passsed straight to tiledb c_api for advanced usage

func (*Query) SetConfig added in v0.11.7 

func (q *Query) SetConfig(config *Config) error

SetConfig config on query

func (*Query) SetLayout 

func (q *Query) SetLayout(layout Layout) error

SetLayout sets the layout of the cells to be written or read

func (*Query) SetQueryCondition added in v0.12.0 

func (q *Query) SetQueryCondition(cond *QueryCondition) error

SetQueryCondition sets a query condition on a read query

func (*Query) SetSubArray 

func (q *Query) SetSubArray(subArray interface{}) error

SetSubArray Sets a subarray, defined in the order dimensions were added. Coordinates are inclusive. For the case of writes, this is meaningful only for dense arrays, and specifically dense writes.

func (*Query) Stats added in v0.12.1 

func (q *Query) Stats() ([]byte, error)

Stats gets stats for a query as json bytes

func (*Query) Status 

func (q *Query) Status() (QueryStatus, error)

Status returns the status of a query

func (*Query) Submit 

func (q *Query) Submit() error

Submit a TileDB query This will block until query is completed

Note: Finalize() must be invoked after finish writing in global layout (via repeated invocations of Submit()), in order to flush any internal state. For the case of reads, if the returned status is TILEDB_INCOMPLETE, TileDB could not fit the entire result in the user’s buffers. In this case, the user should consume the read results (if any), optionally reset the buffers with SetBuffer(), and then resubmit the query until the status becomes TILEDB_COMPLETED. If all buffer sizes after the termination of this function become 0, then this means that no useful data was read into the buffers, implying that the larger buffers are needed for the query to proceed. In this case, the users must reallocate their buffers (increasing their size), reset the buffers with set_buffer(), and resubmit the query.

func (*Query) SubmitAsync 

func (q *Query) SubmitAsync() error

SubmitAsync a TileDB query

Async does not currently support the callback function parameter To monitor progress of a query in a non blocking manner the status can be polled: 

// Start goroutine for background monitoring
go func(query Query) {
 var status QueryStatus
 var err error
  for status, err = query.Status(); status == TILEDB_INPROGRESS && err == nil; status, err = query.Status() {
    // Do something while query is running
  }
  // Do something when query is finished
}(query)

func (*Query) Type 

func (q *Query) Type() (QueryType, error)

Type returns the query type

type QueryCondition added in v0.12.0 

type QueryCondition struct {
	// contains filtered or unexported fields
}

QueryCondition defines a condition used for a query.

func NewQueryCondition added in v0.12.0 

func NewQueryCondition(tdbCtx *Context, attributeName string, op QueryConditionOp, value interface{}) (*QueryCondition, error)

NewQueryCondition allocates and initializes a new query condition

func NewQueryConditionCombination added in v0.12.0 

func NewQueryConditionCombination(tdbCtx *Context, left *QueryCondition, op QueryConditionCombinationOp, right *QueryCondition) (*QueryCondition, error)

NewQueryConditionCombination combines two query conditions to create a new query condition. The underlying conditions are unchanged

func (*QueryCondition) Context added in v0.14.2 

func (qc *QueryCondition) Context() *Context

Context exposes the internal TileDB context used to initialize the query condition

func (*QueryCondition) Free added in v0.12.0 

func (qc *QueryCondition) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

type QueryConditionCombinationOp added in v0.12.0 

type QueryConditionCombinationOp uint8

QueryConditionCombinationOp operation type for a query condition combination 

const (
	// TILEDB_QUERY_CONDITION_AND defines the query condition for an and combination
	TILEDB_QUERY_CONDITION_AND QueryConditionCombinationOp = C.TILEDB_AND
	// TILEDB_QUERY_CONDITION_AND defines the query condition for an or combination
	TILEDB_QUERY_CONDITION_OR QueryConditionCombinationOp = C.TILEDB_OR
	// TILEDB_QUERY_CONDITION_AND defines the query condition for a not combination
	TILEDB_QUERY_CONDITION_NOT QueryConditionCombinationOp = C.TILEDB_NOT
)

type QueryConditionOp added in v0.12.0 

type QueryConditionOp uint8

QueryConditionOp operation type for a query condition 

const (
	// TILEDB_QUERY_CONDITION_LT defines the query condition for a less than comparison
	TILEDB_QUERY_CONDITION_LT QueryConditionOp = C.TILEDB_LT
	// TILEDB_QUERY_CONDITION_LE defines the query condition for a less than or equal to comparison
	TILEDB_QUERY_CONDITION_LE QueryConditionOp = C.TILEDB_LE
	// TILEDB_QUERY_CONDITION_GT defines the query condition for a greater than comparison
	TILEDB_QUERY_CONDITION_GT QueryConditionOp = C.TILEDB_GT
	// TILEDB_QUERY_CONDITION_GE defines the query condition for a greater than or equal to comparison
	TILEDB_QUERY_CONDITION_GE QueryConditionOp = C.TILEDB_GE
	// TILEDB_QUERY_CONDITION_EQ defines the query condition for an equal to comparison
	TILEDB_QUERY_CONDITION_EQ QueryConditionOp = C.TILEDB_EQ
	// TILEDB_QUERY_CONDITION_NE defines the query condition for a not equal to comparison
	TILEDB_QUERY_CONDITION_NE QueryConditionOp = C.TILEDB_NE
)

type QueryStatus 

type QueryStatus int8

QueryStatus status of a query 

const (
	// TILEDB_FAILED Query failed
	TILEDB_FAILED QueryStatus = C.TILEDB_FAILED
	// TILEDB_COMPLETED Query completed (all data has been read)
	TILEDB_COMPLETED QueryStatus = C.TILEDB_COMPLETED
	// TILEDB_INPROGRESS Query is in progress
	TILEDB_INPROGRESS QueryStatus = C.TILEDB_INPROGRESS
	// TILEDB_INCOMPLETE Query completed (but not all data has been read)
	TILEDB_INCOMPLETE QueryStatus = C.TILEDB_INCOMPLETE
	// TILEDB_UNINITIALIZED Query not initialized.
	TILEDB_UNINITIALIZED QueryStatus = C.TILEDB_UNINITIALIZED
)

func (QueryStatus) String added in v0.11.8 

func (q QueryStatus) String() string

String returns string representation

type QueryType 

type QueryType int8

QueryType read or write query 

const (
	// TILEDB_READ Read query
	TILEDB_READ QueryType = C.TILEDB_READ
	// TILEDB_WRITE Write query
	TILEDB_WRITE QueryType = C.TILEDB_WRITE
)

type RangeLimits added in v0.7.1 

type RangeLimits struct {
	// contains filtered or unexported fields
}

RangeLimits defines a query range

func (RangeLimits) MarshalJSON added in v0.8.1 

func (r RangeLimits) MarshalJSON() ([]byte, error)

MarshalJSON implements the Marshaler interface for RangeLimits

type SerializationType added in v0.6.0 

type SerializationType int8

SerializationType how data is serialized 

const (
	// TILEDB_JSON Serialization to/from json
	TILEDB_JSON SerializationType = C.TILEDB_JSON

	// TILEDB_JSON Serialization to/from capnp
	TILEDB_CAPNP SerializationType = C.TILEDB_CAPNP
)

type VFS 

type VFS struct {
	// contains filtered or unexported fields
}

VFS Implements a virtual filesystem that enables performing directory/file operations with a unified API on different filesystems, such as local posix/windows, HDFS, AWS S3, etc.

func NewVFS 

func NewVFS(context *Context, config *Config) (*VFS, error)

NewVFS alloc a new context using tiledb_vfs_alloc. This also registers the `runtime.SetFinalizer` for handling the free'ing of the c data structure on garbage collection

Example

ExampleNewVFS show basic usage of tiledb's vfs functionality 

// Create a new config
config, err := NewConfig()
if err != nil {
	// return err
}
// Optionally set config settings here
// config.Set("key", "value")

// Create a context
context, err := NewContext(config)
if err != nil {
	// return err
}

// Create a VFS instance
vfs, err := NewVFS(context, config)
if err != nil {
	// return err
}

uri := "file:///tmp/tiledb_example_folder"
// Check if directory exists
if isDir, err := vfs.IsDir(uri); err != nil {
	fmt.Println(err)
} else {
	// Directory exists
	if isDir {
		fmt.Println("URI is a directory")
		// Output: URI is a directory
	} else {
		fmt.Println("URI is not a directory")
		

Output:

URI is not a directory

func (*VFS) Close 

func (v *VFS) Close(fh *VFSfh) error

Close a file. This is flushes the buffered data into the file when the file was opened in write (or append) mode. It is particularly important to be called after S3 writes, as otherwise the writes will not take effect.

func (*VFS) Config added in v0.5.0 

func (v *VFS) Config() (*Config, error)

Config retrieves a copy of the config from vfs

func (*VFS) Context added in v0.14.2 

func (v *VFS) Context() *Context

Context exposes the internal TileDB context used to initialize the vfs

func (*VFS) CopyFile added in v0.10.2 

func (v *VFS) CopyFile(oldURI string, newURI string) error

CopyFile renames a TileDB file from an old URI to a new URI.

func (*VFS) CreateBucket 

func (v *VFS) CreateBucket(uri string) error

CreateBucket creates an object-store bucket with the input URI.

func (*VFS) CreateDir 

func (v *VFS) CreateDir(uri string) error

CreateDir creates a directory with the input URI.

func (*VFS) DirSize added in v0.4.0 

func (v *VFS) DirSize(uri string) (uint64, error)

DirSize retrieves the size of a directory.

func (*VFS) EmptyBucket 

func (v *VFS) EmptyBucket(uri string) error

EmptyBucket empty a bucket

func (*VFS) FileSize 

func (v *VFS) FileSize(uri string) (uint64, error)

FileSize retrieves the size of a file.

func (*VFS) Free 

func (v *VFS) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*VFS) IsBucket 

func (v *VFS) IsBucket(uri string) (bool, error)

IsBucket checks if an object-store bucket with the input URI exists.

func (*VFS) IsDir 

func (v *VFS) IsDir(uri string) (bool, error)

IsDir checks if a directory with the input URI exists.

func (*VFS) IsEmptyBucket 

func (v *VFS) IsEmptyBucket(uri string) (bool, error)

IsEmptyBucket check if a bucket is empty

func (*VFS) IsFile 

func (v *VFS) IsFile(uri string) (bool, error)

IsFile checks if a file with the input URI exists.

func (*VFS) List added in v0.14.4 

func (v *VFS) List(path string) ([]string, []string, error)

List returns list of folders and files in a path

func (*VFS) MoveDir 

func (v *VFS) MoveDir(oldURI string, newURI string) error

MoveDir menames a TileDB directory from an old URI to a new URI.

func (*VFS) MoveFile 

func (v *VFS) MoveFile(oldURI string, newURI string) error

MoveFile renames a TileDB file from an old URI to a new URI.

func (*VFS) NumOfFragmentsInPath added in v0.10.0 

func (v *VFS) NumOfFragmentsInPath(path string) (int, error)

NumOfFragmentsInPath returns number of folders in a path

func (*VFS) Open 

func (v *VFS) Open(uri string, mode VFSMode) (*VFSfh, error)

Open prepares a file for reading/writing.

func (*VFS) Read 

func (v *VFS) Read(fh *VFSfh, offset uint64, nbytes uint64) ([]byte, error)

Read part of a file

func (*VFS) RemoveBucket 

func (v *VFS) RemoveBucket(uri string) error

RemoveBucket deletes an object-store bucket with the input URI.

func (*VFS) RemoveDir 

func (v *VFS) RemoveDir(uri string) error

RemoveDir removes a directory (recursively) with the input URI.

func (*VFS) RemoveFile 

func (v *VFS) RemoveFile(uri string) error

RemoveFile deletes a file with the input URI.

func (*VFS) Sync 

func (v *VFS) Sync(fh *VFSfh) error

Sync (flushes) a file.

func (*VFS) Touch 

func (v *VFS) Touch(uri string) error

Touch a file, i.e., creates a new empty file.

func (*VFS) Write 

func (v *VFS) Write(fh *VFSfh, bytes []byte) error

Write the contents of a buffer into a file. Note that this function only appends data at the end of the file. If the file does not exist, it will be created

type VFSMode 

type VFSMode int8

VFSMode is virtual file system file open mode 

const (
	// TILEDB_VFS_READ open file in read mode
	TILEDB_VFS_READ VFSMode = C.TILEDB_VFS_READ

	// TILEDB_VFS_WRITE open file in write mode
	TILEDB_VFS_WRITE VFSMode = C.TILEDB_VFS_WRITE

	// TILEDB_VFS_APPENDopen file in write append mode
	TILEDB_VFS_APPEND VFSMode = C.TILEDB_VFS_APPEND
)

type VFSfh 

type VFSfh struct {
	// contains filtered or unexported fields
}

VFSfh is a virtual file system file handler

func (*VFSfh) Close added in v0.10.3 

func (v *VFSfh) Close() error

Close a file. This is flushes the buffered data into the file when the file was opened in write (or append) mode. It is particularly important to be called after S3 writes, as otherwise the writes will not take effect.

func (*VFSfh) Context added in v0.14.2 

func (v *VFSfh) Context() *Context

Context exposes the internal TileDB context used to initialize the vfsh

func (*VFSfh) Free 

func (v *VFSfh) Free()

Free releases the internal TileDB core data that was allocated on the C heap. It is automatically called when this object is garbage collected, but can be called earlier to manually release memory if needed. Free is idempotent and can safely be called many times on the same object; if it has already been freed, it will not be freed again.

func (*VFSfh) IsClosed 

func (v *VFSfh) IsClosed() (bool, error)

IsClosed checks a vfs file handler to see if it is closed. Return true if file handler is closed, false if its not closed and error is non-nil on error

func (*VFSfh) Read added in v0.10.3 

func (v *VFSfh) Read(p []byte) (int, error)

Read part of a file

func (*VFSfh) Seek added in v0.10.3 

func (v *VFSfh) Seek(offset int64, whence int) (int64, error)

Seek to an offset

func (*VFSfh) Sync added in v0.10.3 

func (v *VFSfh) Sync() error

Sync (flushes) a file.

func (*VFSfh) Write added in v0.10.3 

func (v *VFSfh) Write(bytes []byte) (int, error)

Write the contents of a buffer into a file. Note that this function only appends data at the end of the file. If the file does not exist, it will be created

type WalkOrder added in v0.10.3 

type WalkOrder int8

WalkOrder 

const (
	// Pre-order traversal
	TILEDB_PREORDER WalkOrder = C.TILEDB_PREORDER
	// Post-order traversal
	TILEDB_POSTORDER WalkOrder = C.TILEDB_POSTORDER
)

Source Files

View all Source files

Directories

Path Synopsis
Package bytesizes provides constants with the size in bytes of numeric types.
 Package bytesizes provides constants with the size in bytes of numeric types.
cmd
tiledb-go-examples
tiledb-go-examples runs all of TileDB's example code.
 tiledb-go-examples runs all of TileDB's example code.
tools
sizegen
Program sizegen generates a Go file containing the byte size of variables of each Go numeric type, to be used in `go generate`.
 Program sizegen generates a Go file containing the byte size of variables of each Go numeric type, to be used in `go generate`.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.