org.springframework.cloud.gcp.data.spanner.core.admin

Class SpannerDatabaseAdminTemplate

java.lang.Object

org.springframework.cloud.gcp.data.spanner.core.admin.SpannerDatabaseAdminTemplate

public class SpannerDatabaseAdminTemplate
extends Object

Author:

Chengyuan Zhao, Balint Pato

Constructor Summary

Constructors

Constructor and Description
SpannerDatabaseAdminTemplate(com.google.cloud.spanner.DatabaseAdminClient databaseAdminClient, com.google.cloud.spanner.DatabaseClient databaseClient, com.google.cloud.spanner.DatabaseId databaseId) Constructor that takes in the database admin client used to perform operations and the DatabaseId object holding the project, instance, and database IDs used for all operations.

Method Summary

Modifier and Type	Method and Description
boolean	databaseExists() Returns true if the configured database ID refers to an existing database.
void	executeDdlStrings(Iterable<String> ddlStrings, boolean createDatabaseIfNotExists) Execute the given DDL strings in order and creates the database if it does not exist.
Map<String,String>	getChildParentTablesMap() Return a map where key is the table name and the value is the parent table name.
String	getDatabase() Get the database ID used to perform database operations.
String	getInstanceId() Get the instance ID used to perform database operations.
Map<String,Set<String>>	getParentChildTablesMap() Return a map of parent and child table relationships in the database at the moment.
Set<String>	getTables() Return a set of the tables that currently exist in the database.
boolean	tableExists(String table) Returns true if the given table name exists in the database currently.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SpannerDatabaseAdminTemplate

public SpannerDatabaseAdminTemplate(com.google.cloud.spanner.DatabaseAdminClient databaseAdminClient,
                                    com.google.cloud.spanner.DatabaseClient databaseClient,
                                    com.google.cloud.spanner.DatabaseId databaseId)

Constructor that takes in the database admin client used to perform operations and the DatabaseId object holding the project, instance, and database IDs used for all operations. While operations can be optionally performed for a database that does not yet exist, the project and instance IDs must already exist for Spanner.

Parameters:

databaseAdminClient - the client used to create databases and execute DDL statements.

databaseClient - the client used to access schema information tables.

databaseId - the combination of Spanner Instance Id and Database Id. While databases can be created automatically by this template, instances determine billing and are not created automatically.

Method Detail

executeDdlStrings

public void executeDdlStrings(Iterable<String> ddlStrings,
                              boolean createDatabaseIfNotExists)

Execute the given DDL strings in order and creates the database if it does not exist.

Parameters:

ddlStrings -

createDatabaseIfNotExists - Has no effect if the database already exists. Otherwise, if True then the database is created and the DDL strings are executed; the DDL is not executed if False.

getInstanceId

public String getInstanceId()

Get the instance ID used to perform database operations.

Returns:

the instance ID string.

getDatabase

public String getDatabase()

Get the database ID used to perform database operations.

Returns:

the database ID string.

databaseExists

public boolean databaseExists()

Returns true if the configured database ID refers to an existing database. False otherwise.

Returns:

true if the database exists, and false if it does not.

getChildParentTablesMap

public Map<String,String> getChildParentTablesMap()

Return a map where key is the table name and the value is the parent table name. If the table name in the key has no parent then the value is null.

Returns:

the map of the table names.

getParentChildTablesMap

public Map<String,Set<String>> getParentChildTablesMap()

Return a map of parent and child table relationships in the database at the moment.

Returns:

A map where the keys are parent table names, and the value is a set of that parent's children.

getTables

public Set<String> getTables()

Return a set of the tables that currently exist in the database.

Returns:

A set of table names.

tableExists

public boolean tableExists(String table)

Returns true if the given table name exists in the database currently.

Parameters:

table - the name of the table.

Returns:

true if the table exists, false otherwise.