Class BigtableDataClientFactory (2.39.4)

Version 2.39.4

• 2.46.0 (latest)
• 2.45.1
• 2.44.1
• 2.43.0
• 2.42.0
• 2.40.0
• 2.39.5
• 2.37.0
• 2.35.1
• 2.34.0
• 2.33.0
• 2.32.0
• 2.31.0
• 2.30.0
• 2.29.1
• 2.28.0

Beta

This library is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

public final class BigtableDataClientFactory implements AutoCloseable

A factory to create multiple BigtableDataClient instances that all share the same channel pool.

This allows multiple client instances to share the same gRPC channel pool, which makes client creation very cheap. The intended use case is for applications that need to access multiple Bigtable Instances from the same process.

Example Usage:

 BigtableDataSettings defaultSettings = BigtableDataSettings.newBuilder()
   .setProject("my-default-project")
   .setInstance("my-default-instance")
   .build();

 BigtableDataClientFactory clientFactory = BigtableDataClientFactory.create(defaultSettings);

 // Create a new client for "my-default-instance" in "my-default-project";
 BigtableDataClient defaultInstanceClient = clientFactory.createDefault();

 // Create a new client for a different application profile
 BigtableDataClient otherAppProfileClient = clientFactory.createForAppProfile("other-app-profile");

 // Create a new client for a completely different instance and application profile.
 BigtableDataClient otherInstanceClient = clientFactory
   .createForInstance("my-other-project", "my-other-instance", "my-other-app-profile");

 // Clean up: make sure close the clients AND the factory.
 defaultInstanceClient.close();
 otherAppProfileClient.close();
 otherInstanceClient.close();

 clientFactory.close();

 
Please note that this is an experimental feature and might be changed or removed in future.
 

Inheritance

java.lang.Object > BigtableDataClientFactory

Implements

AutoCloseable

Inherited Members

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Static Methods

create(BigtableDataSettings defaultSettings)

public static BigtableDataClientFactory create(BigtableDataSettings defaultSettings)

Create a instance of this factory.

The factory will be used to create clients using the provided settings as the base. Make sure to call #close() on the factory after closing all clients.

Parameter
Name	Description
defaultSettings	BigtableDataSettings

Returns
Type	Description
BigtableDataClientFactory

Exceptions
Type	Description
IOException

Methods

close()

public void close()

Release all of the resources associated with this factory.

This will close the underlying channel pooling, disconnecting all create clients.

Exceptions
Type	Description
Exception

createDefault()

public BigtableDataClient createDefault()

Create a lightweight client using the default settings in this factory. This will use the factory default project, instance and application profile ids. The client will also share resources like the channel pool with other clients created using this factory.

The client should be closed when it is no longer needed. Closing the client will release client specific resources, but will leave shared resources like the channel pool open. To release all resources, first close all of the created clients and then this factory instance.

Returns
Type	Description
BigtableDataClient

createForAppProfile(String appProfileId)

public BigtableDataClient createForAppProfile(String appProfileId)

Create a lightweight client with an overriden application profile and the factory default project and instance ids. The client will also share resources like the channel pool with other clients created using this factory.

The client should be closed when it is no longer needed. Closing the client will release client specific resources, but will leave shared resources like the channel pool open. To release all resources, first close all of the created clients and then this factory instance.

Parameter
Name	Description
appProfileId	String

Returns
Type	Description
BigtableDataClient

Exceptions
Type	Description
IOException

createForInstance(String projectId, String instanceId)

public BigtableDataClient createForInstance(String projectId, String instanceId)

Create a lightweight client with the specified project and instance id. The resulting client will use the server default application profile. The client will also share resources like the channel pool with other clients created using this factory.

The client should be closed when it is no longer needed. Closing the client will release client specific resources, but will leave shared resources like the channel pool open. To release all resources, first close all of the created clients and then this factory instance.

Parameters
Name	Description
projectId	String
instanceId	String

Returns
Type	Description
BigtableDataClient

Exceptions
Type	Description
IOException

createForInstance(String projectId, String instanceId, String appProfileId)

public BigtableDataClient createForInstance(String projectId, String instanceId, String appProfileId)

Create a lightweight client to the specified project, instance and application profile id. The client will share resources like the channel pool with other clients created using this factory.

The client should be closed when it is no longer needed. Closing the client will release client specific resources, but will leave shared resources like the channel pool open. To release all resources, first close all of the created clients and then this factory instance.

Parameters
Name	Description
projectId	String
instanceId	String
appProfileId	String

Returns
Type	Description
BigtableDataClient

Exceptions
Type	Description
IOException