Get a database object (Go)

When using a client, most Data API interactions require you to connect to a database through a DataAPIClient object.

Connecting to a database is an essential component of most Data API client scripts. For more information, see Get started with the Data API (Go).

For more information about the Data API client hierarchy, see Python client internals, TypeScript client internals, Go client internals, Java client internals, and C# client internals.

Result

Returns a Db struct that you can use to perform CRUD operations on your database

Parameters

Use the Database method, which belongs to the DataAPIClient type.

Method signature

func (c *DataAPIClient) Database(
  endpoint string,
  opts ...options.APIOption
) *Db

Name Type Summary

Name	Type	Summary
`endpoint`	`string`	A database API endpoint URL, such as `https://DATABASE_ID-REGION.apps.astra.datastax.com`.
`opts`	`…options.APIOption`	Optional. A specification of options to override the inherited defaults. Use this to customize the interaction of the client with the admin object. For example, you can change the default timeouts or token. You can override these options in downstream Data API operations. See Methods of the `options.APIOption` builder for more details.

endpoint

string

A database API endpoint URL, such as https://DATABASE_ID-REGION.apps.astra.datastax.com.

opts

…options.APIOption

Optional. A specification of options to override the inherited defaults. Use this to customize the interaction of the client with the admin object. For example, you can change the default timeouts or token.

You can override these options in downstream Data API operations.

See Methods of the options.APIOption builder for more details.

Methods of the `options.APIOption` builder
Method	Summary
`SetToken(token string)`	Optional. An application token for a database, in the form of an `"AstraCS:…"` string. The token should have sufficient permissions to perform the desired operations.
`SetAstraEnvironment(v AstraEnvironment)`	Optional. Specify the environment this client will work in. Default: `options.AstraEnvironmentProd`.
`SetGeneralMethodTimeout(v time.Duration)`	Optional. The maximum time that the client should wait for an entire operation, which may involve multiple HTTP requests, to complete. Default: 30 seconds
`SetRequestTimeout(v time.Duration)`	Optional. The maximum time that the client should wait for individual HTTP requests. Default: 15 seconds
`SetDatabaseAdminTimeout(v time.Duration)`	Optional. The maximum time that the client should wait for database administrative operations like `CreateDatabase` and `DropDatabase`. Default: 10 minutes
`SetKeyspaceAdminTimeout(v time.Duration)`	Optional. The maximum time that the client should wait for keyspace administrative operations like `CreateKeyspace` and `DropKeyspace`. Default: 30 seconds
`SetCollectionAdminTimeout(v time.Duration)`	Optional. The maximum time that the client should wait for collection administrative operations like `CreateCollection` and `DropCollection`. Default: 60 seconds
`SetTableAdminTimeout(v time.Duration)`	Optional. The maximum time that the client should wait for table administrative operations like `CreateTable`, `CreateIndex`, and `CreateType`. Default: 30 seconds
`UpdateTimeout(v …options.TimeoutOption)`	Optional. An alternative to `SetGeneralMethodTimeout()`, `SetRequestTimeout()`, `SetDatabaseAdminTimeout()`, `SetKeyspaceAdminTimeout()`, `SetCollectionAdminTimeout()`, and `SetTableAdminTimeout()`.
`SetEnvironment(v options.Environment)`	Optional. Sets the database backend. Default: `options.EnvironmentAstra`
`SetKeyspace(v string)`	Optional. Specify the working keyspace. This keyspace is used for all downstream operations unless you later override it with a method such as `UseKeyspace`, `Collection`, `CreateCollection`, `Table`, or `CreateTable`. Default: default_keyspace
`AddHeader(key string, value string)`	Optional. Specifies headers for all HTTP requests to the Data API.
`AddCaller(name string, version string)`	Optional. Attaches special identifying entries to the User-Agent header for all HTTP requests to the Data API.
`SetAPIVersion(v string)`	Optional. Sets the Data API version. Default: v1
`SetHTTPClient(v *http.Client)`	Optional. Sets the HTTP client to use for requests.
`SetWarningHandler(handler options.WarningHandler)`	Optional. Specifies a callback function that is invoked for warnings emitted by the Data API. Data API warnings indicate non-fatal conditions that don’t prevent the operation from completing, such as missing indexes or deprecated features.
`UpdateSerdes(v …options.SerdesOption)`	Optional. Sets the serialization/deserialization options.

Examples

The following examples demonstrate how to connect to a database.

package main

import (
	"github.com/datastax/astra-db-go/v2/astra"
	"github.com/datastax/astra-db-go/v2/astra/options"
)

func main() {

	client := astra.NewClient()

	_ = client.Database(
		"API_ENDPOINT",
		options.API().SetToken("APPLICATION_TOKEN"),
	)
}

Client reference

For more information, see the client reference.

Get a database object (Go)

Result

Parameters

Examples

Client reference

Was this helpful?

Give Feedback