Google Cloud Spanner C++ Client
A C++ Client Library for Google Cloud Spanner
Public Member Functions | Friends | List of all members
google::cloud::spanner::v1::Database Class Reference

This class identifies a Cloud Spanner Database. More...

#include <google/cloud/spanner/database.h>

Public Member Functions

 Database (Instance instance, std::string database_id)
 Constructs a Database object identified by the given database_id and instance. More...
 
 Database (std::string project_id, std::string instance_id, std::string database_id)
 Constructs a Database object identified by the given IDs. More...
 
std::string FullName () const
 Returns the fully qualified database name as a string of the form: "projects/<project-id>/instances/<instance-id>/databases/<database-id>". More...
 
Instance const & instance () const
 Returns the Instance containing this database. More...
 
std::string const & database_id () const
 
Copy and move
 Database (Database const &)=default
 
Databaseoperator= (Database const &)=default
 
 Database (Database &&)=default
 
Databaseoperator= (Database &&)=default
 

Friends

std::ostream & operator<< (std::ostream &os, Database const &dn)
 Output the FullName() format. More...
 
Equality operators
bool operator== (Database const &a, Database const &b)
 
bool operator!= (Database const &a, Database const &b)
 

Detailed Description

This class identifies a Cloud Spanner Database.

A Cloud Spanner database is identified by its project_id, instance_id, and database_id.

Note
this class makes no effort to validate the components of the database name. It is the application's responsibility to provide valid project, instance, and database ids. Passing invalid values will not be checked until the database name is used in a RPC to spanner.

For more info about the database_id format, see https://cloud.google.com/spanner/docs/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.CreateDatabaseRequest

Definition at line 43 of file database.h.

Constructor & Destructor Documentation

◆ Database() [1/4]

google::cloud::spanner::v1::Database::Database ( Instance  instance,
std::string  database_id 
)

Constructs a Database object identified by the given database_id and instance.

Definition at line 23 of file database.cc.

◆ Database() [2/4]

google::cloud::spanner::v1::Database::Database ( std::string  project_id,
std::string  instance_id,
std::string  database_id 
)

Constructs a Database object identified by the given IDs.

This is equivalent to first constructing an Instance from the given project_id and instance_id arguments then calling the Database(Instance, std::string) constructor.

Definition at line 26 of file database.cc.

◆ Database() [3/4]

google::cloud::spanner::v1::Database::Database ( Database const &  )
default

◆ Database() [4/4]

google::cloud::spanner::v1::Database::Database ( Database &&  )
default

Member Function Documentation

◆ database_id()

std::string const& google::cloud::spanner::v1::Database::database_id ( ) const
inline

Definition at line 75 of file database.h.

◆ FullName()

std::string google::cloud::spanner::v1::Database::FullName ( ) const

Returns the fully qualified database name as a string of the form: "projects/<project-id>/instances/<instance-id>/databases/<database-id>".

Definition at line 31 of file database.cc.

◆ instance()

Instance const& google::cloud::spanner::v1::Database::instance ( ) const
inline

Returns the Instance containing this database.

Definition at line 74 of file database.h.

◆ operator=() [1/2]

Database& google::cloud::spanner::v1::Database::operator= ( Database const &  )
default

◆ operator=() [2/2]

Database& google::cloud::spanner::v1::Database::operator= ( Database &&  )
default

Friends And Related Function Documentation

◆ operator!=

bool operator!= ( Database const &  a,
Database const &  b 
)
friend

Definition at line 39 of file database.cc.

◆ operator<<

std::ostream& operator<< ( std::ostream &  os,
Database const &  dn 
)
friend

Output the FullName() format.

Definition at line 41 of file database.cc.

◆ operator==

bool operator== ( Database const &  a,
Database const &  b 
)
friend

Definition at line 35 of file database.cc.