Membuat instance

Instance Bigtable berfungsi sebagai container tingkat teratas untuk cluster dan tabel Anda, sehingga Anda dapat mengonfigurasi penyimpanan dan replikasi di hingga 8 region untuk ketersediaan tinggi. Anda dapat membuat dan mengonfigurasi instance menggunakan konsol Google Cloud , Google Cloud CLI, cbt CLI , atau library klien Cloud Bigtable.

Sebelum memulai

Pastikan Anda memahami Ringkasan Bigtable dan Instance, cluster, dan node.

Menyiapkan lingkungan Anda:

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  4. Install the Google Cloud CLI.

  5. Configure the gcloud CLI to use your federated identity.

    For more information, see Sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init
  7. Jalankan perintah berikut untuk menginstal cbt CLI: 
    gcloud components install cbt

Merencanakan konfigurasi Anda:

  1. Opsional: Jika Anda berencana mengaktifkan replikasi, lakukan hal berikut:

  2. Opsional: Jika Anda ingin menggunakan kunci enkripsi yang dikelola pelanggan (CMEK), bukan enkripsi default yang dikelola Google, siapkan ID kunci CMEK Anda sebelum membuat instance baru. Anda tidak dapat menambahkan perlindungan CMEK ke instance setelah instance dibuat, dan Anda tidak dapat mengubah atau mengganti kunci CMEK setelah instance dibuat. Untuk informasi selengkapnya, lihat Menggunakan kunci enkripsi yang dikelola pelanggan (CMEK).

Membuat instance

Untuk membuat instance Bigtable:

Konsol

  1. Di konsol Google Cloud , buka halaman Create instance.

    Buka Create instance

  2. Masukkan nama untuk instance.

    Konsol Google Cloud menampilkan nama ini untuk mengidentifikasi instance Anda.

  3. Masukkan ID instance.

    ID instance adalah ID permanen untuk instance.

  4. Klik Lanjutkan.

  5. Di bagian Select your edition, pilih edisi Bigtable.

    Jika Anda ingin membandingkan spesifikasi antar-edisi, klik Bandingkan edisi. Untuk mengetahui informasi selengkapnya, lihat Ringkasan edisi.

  6. Klik Lanjutkan.

  7. Pilih apakah akan menggunakan disk SSD atau HDD untuk cluster Anda. Dalam sebagian besar kasus, SSD adalah yang terbaik. Jika Anda ingin mengaktifkan tingkat dalam memori, pilih SSD. Pilihan ini bersifat permanen.

  8. Klik Lanjutkan.

  9. Masukkan ID cluster untuk cluster pertama.

    ID cluster adalah ID permanen untuk cluster.

  10. Pilih region dan zona tempat cluster pertama akan dijalankan.

  11. Opsional: Untuk mengonfigurasi cluster agar selalu diskalakan dalam kelipatan dua node, pilih Enable 2x node scaling. Penskalaan node 2x tidak tersedia di semua zona. Untuk edisi Enterprise Plus, penskalaan node 2x adalah opsi default. Untuk mengetahui informasi selengkapnya, lihat Faktor penskalaan node.

  12. Opsional: Untuk menggunakan tingkat dalam memori di level cluster, pilih Enable in-memory.

  13. Pilih mode penskalaan node untuk cluster. Pada umumnya, Anda harus memilih penskalaan otomatis. Untuk panduan penskalaan, lihat Penskalaan otomatis.

    1. Untuk Manual node allocation, masukkan jumlah node Bigtable untuk cluster pertama. Jika Anda tidak yakin berapa banyak node yang diperlukan, gunakan default. Anda dapat menambahkan lebih banyak node nanti.
    2. Untuk Autoscaling, masukkan nilai untuk hal berikut:
      • Jumlah node minimum
      • Jumlah node maksimum
      • CPU utilization target
      • Target pemanfaatan penyimpanan

  14. Opsional: Untuk melindungi instance Anda dengan CMEK, bukan enkripsi default yang dikelola Google, selesaikan langkah-langkah berikut:

    1. Klik Tampilkan opsi enkripsi.
    2. Pilih Cloud KMS key.
    3. Di kolom Key management type, pilih salah satu opsi berikut:
      • Jika Anda ingin mengotomatiskan pembuatan kunci Cloud KMS, pilih Cloud KMS with Autokey, lalu klik Request a key. Pesan akan menunjukkan kapan kunci Anda berhasil dibuat dan siap digunakan.
      • Jika Anda ingin menambahkan kunci secara manual, pilih Cloud KMS. Pilih atau masukkan nama resource untuk kunci CMEK yang ingin Anda gunakan untuk cluster. Anda tidak dapat menambahkannya nanti. Jika Anda diminta untuk memberikan izin ke akun layanan kunci CMEK, klik Grant. Akun pengguna Anda harus diberi peran Cloud KMS Admin untuk menyelesaikan tugas ini. Klik Simpan.

  15. Opsional: Untuk mengaktifkan replikasi sekarang, selesaikan langkah-langkah tambahan berikut:

    1. Klik Tampilkan opsi lanjutan.
    2. Klik Add cluster, masukkan setelan untuk cluster, lalu klik Add. Ulangi langkah ini untuk membuat cluster tambahan di instance. Anda juga dapat mengaktifkan replikasi nanti dengan menambahkan cluster.

    Setiap zona di suatu region hanya dapat berisi satu cluster. Jika tombol Add cluster dinonaktifkan, ubah zona untuk cluster pertama Anda.

    Untuk membuat instance yang memiliki lebih dari enam cluster, buat instance yang memiliki enam cluster terlebih dahulu, lalu tambahkan lebih banyak cluster ke instance tersebut.

  16. Klik Create untuk membuat instance.

  17. Tinjau setelan replikasi di profil aplikasi default untuk melihat apakah setelan tersebut sesuai untuk kasus penggunaan replikasi Anda. Anda mungkin perlu memperbarui profil aplikasi default atau membuat profil aplikasi kustom.

gcloud

  1. Gunakan perintah bigtable instances create untuk membuat instance:

    gcloud bigtable instances create INSTANCE_ID \
    --display-name=DISPLAY_NAME \
    [--edition=EDITION] \
    [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \
    [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \
    nodes=NODES] \
    [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \
    autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \
    autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \
    autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, \
    autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET, \
    kms-key=KMS_KEY], \
    [node-scaling-factor=NODE_SCALING_FACTOR]

    Ganti kode berikut:

    • INSTANCE_ID: ID permanen untuk instance
    • DISPLAY_NAME: Nama yang dapat dibaca manusia yang mengidentifikasi instance di konsol Google Cloud .
    • CLUSTER_ID: ID permanen untuk cluster
    • CLUSTER_ZONE: Zona tempat cluster berjalan.

    Anda harus mengonfigurasi setidaknya satu cluster untuk instance, menggunakan flag --cluster-config. Untuk membuat instance yang memiliki beberapa cluster, ulangi flag --cluster-config untuk setiap cluster.

    Untuk alokasi node manual, menetapkan nodes dalam flag --cluster-config bersifat opsional. Jika tidak ada nilai yang ditetapkan, Bigtable akan mengalokasikan node ke cluster secara otomatis berdasarkan jejak data Anda dan mengoptimalkan penggunaan penyimpanan sebesar 50%. Alokasi node otomatis ini memiliki dampak harga. Jika Anda ingin mengontrol jumlah node dalam cluster, ganti NODES dengan jumlah node yang Anda inginkan dalam cluster. Pelajari node lebih lanjut.

    Umumnya, pilih penskalaan otomatis, bukan alokasi node manual. Untuk penskalaan otomatis, berikan opsi autoscaling- di flag --cluster-config (autoscaling-storage-target bersifat opsional) dan jangan gunakan nodes. Lihat Penskalaan otomatis untuk mendapatkan panduan dalam memilih nilai untuk setelan penskalaan otomatis Anda. Ganti hal berikut untuk kunci opsi cluster-config:

    • AUTOSCALING_MIN_NODES: Jumlah minimum node untuk cluster.
    • AUTOSCALING_MAX_NODES: Jumlah maksimum node untuk cluster.
    • AUTOSCALING_CPU_TARGET: Persentase target pemakaian CPU untuk cluster. Nilai ini harus antara 10 hingga 80.
    • AUTOSCALING_STORAGE_TARGET: (Opsional) Target pemakaian penyimpanan dalam GiB yang dipertahankan Bigtable dengan menambahkan atau menghapus node.

    • KMS_KEY: Kunci CMEK untuk cluster.

      Nilai KMS_KEY harus ditetapkan dalam format berikut:

      projects/PROJECT/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY

      Ganti kode berikut:

      • PROJECT: ID permanen untuk project
      • LOCATION: lokasi cluster Anda
      • KEYRING: nama key ring yang berisi kunci
      • KEY: nama kunci

      Berikut adalah contohnya:

      projects/examplestore.com:dev/locations/us-east1/keyRings/devt-cmek-2/cryptoKeys/key2

      Jika instance dilindungi CMEK, setiap cluster harus berada di region yang sama dengan kunci CMEK-nya. Anda hanya dapat menambahkan cluster CMEK ke instance yang sudah dilindungi CMEK.

    Perintah ini menerima flag opsional berikut:

    • --edition=EDITION: edisi instance yang Anda buat. Nilai yang diterima adalah ENTERPRISE dan ENTERPRISE_PLUS. Nilai defaultnya adalah ENTERPRISE.

    • --cluster-storage-type=CLUSTER_STORAGE_TYPE: jenis penyimpanan yang akan digunakan untuk instance. Nilai defaultnya adalah SSD. Biasanya, nilai default adalah yang terbaik. Pilihan ini bersifat permanen. Pelajari lebih lanjut.

    • --project=PROJECT: project tempat membuat cluster jika berbeda dengan project saat ini.

    • node-scaling-factor=NODE_SCALING_FACTOR: flag yang mengaktifkan penskalaan node 2x. Anda dapat mengaktifkan fitur ini dengan penskalaan manual dan penskalaan otomatis. Nilai yang dapat diterima adalah node-scaling-factor-2x atau node-scaling-factor-1x.

      Untuk melihat daftar zona Bigtable yang tidak tersedia untuk penskalaan node 2x, lihat Batasan faktor penskalaan node.

    • --tags=TAGKEY_NAME=TAGVALUE_NAME: flag yang menambahkan tag ke instance baru. Anda dapat menentukan kunci tag dan nilai tag berdasarkan ID permanen atau nama dengan namespace. Anda dapat memberikan beberapa tag sebagai daftar yang dipisahkan koma, misalnya:

      • Menggunakan ID permanen:
        --tags=tagKeys/984321798431=tagValues/567890123456,
        tagKeys/123456789012=tagValues/098765432109
      • Menggunakan nama dengan namespace:
        --tags=123456789012/environment=123456789012/environment/prod,
        123456789012/costcenter=123456789012/costcenter/marketing

  2. Tinjau setelan replikasi di profil aplikasi default untuk melihat apakah setelan tersebut sesuai untuk kasus penggunaan replikasi Anda. Anda mungkin perlu memperbarui profil aplikasi default atau membuat profil aplikasi kustom.

cbt

  1. Mulailah dengan membuat instance dengan satu cluster. Gunakan perintah createinstance untuk membuat instance:

    cbt createinstance INSTANCE_ID \
    DISPLAY_NAME \
    CLUSTER_ID \
    CLUSTER_ZONE \
    CLUSTER_NUM_NODES \
    CLUSTER_STORAGE_TYPE

    Berikan hal berikut:

    • INSTANCE_ID: ID permanen untuk instance
    • DISPLAY_NAME: Nama yang dapat dibaca manusia yang mengidentifikasi instance di konsol Google Cloud .
    • CLUSTER_ID: ID permanen untuk cluster
    • CLUSTER_ZONE: Zona tempat cluster berjalan.
    • CLUSTER_NUM_NODES: Kolom ini bersifat opsional. Jika tidak ada nilai yang ditetapkan, Bigtable akan otomatis mengalokasikan node berdasarkan jejak data Anda dan mengoptimalkan pemakaian penyimpanan sebesar 50%. Jika Anda ingin mengontrol jumlah node dalam cluster, perbarui nilai CLUSTER_NUM_NODES. Pastikan jumlah node ditetapkan ke nilai bukan nol. Pelajari node lebih lanjut.
    • CLUSTER_STORAGE_TYPE: Jenis penyimpanan yang akan digunakan untuk cluster. Setiap cluster dalam instance harus menggunakan jenis penyimpanan yang sama. Menerima nilai SSD dan HDD. Dalam sebagian besar kasus, SSD adalah yang terbaik. Pilihan ini bersifat permanen. Pelajari lebih lanjut.

  2. Untuk mengaktifkan replikasi, gunakan perintah createcluster untuk menambahkan cluster:

    
cbt -instance=INSTANCE_ID \
createcluster CLUSTER_ID \
ZONE \
NUM_NODES \
STORAGE_TYPE

    Berikan hal berikut:

    • INSTANCE_ID: ID permanen untuk instance yang baru saja Anda buat
    • CLUSTER_ID: ID permanen untuk cluster

    • ZONE: Zona tempat cluster berjalan.

      Setiap zona di suatu region hanya dapat berisi satu cluster. Misalnya, jika instance memiliki cluster di us-east1-b, Anda dapat menambahkan cluster di zona berbeda di region yang sama, seperti us-east1-c, atau zona di region terpisah, seperti europe-west2-a.

    • NUM_NODES: Kolom ini bersifat opsional. Jika tidak ada nilai yang ditetapkan, Bigtable akan otomatis mengalokasikan node berdasarkan jejak data Anda dan mengoptimalkan pemakaian penyimpanan sebesar 50%. Jika Anda ingin mengontrol jumlah node dalam cluster, perbarui nilai NUM_NODES. Pastikan jumlah node ditetapkan ke nilai bukan nol.

      Dalam banyak kasus, setiap cluster dalam instance harus memiliki jumlah node yang sama, tetapi ada pengecualian. Pelajari node dan replikasi.

    • STORAGE_TYPE: Jenis penyimpanan yang akan digunakan untuk cluster. Setiap cluster dalam instance harus menggunakan jenis penyimpanan yang sama. Menerima nilai SSD dan HDD.

  3. (Opsional) Tinjau setelan replikasi di profil aplikasi default untuk melihat apakah setelan tersebut sesuai untuk kasus penggunaan replikasi Anda. Anda mungkin perlu memperbarui profil aplikasi default atau membuat profil aplikasi kustom.

C++

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

namespace cbta = ::google::cloud::bigtable_admin;
using ::google::cloud::future;
using ::google::cloud::Location;
using ::google::cloud::Project;
using ::google::cloud::StatusOr;
[](cbta::BigtableInstanceAdminClient instance_admin,
   std::string const& project_id, std::string const& instance_id,
   std::string const& zone) {
  auto const project = Project(project_id);
  std::string project_name = project.FullName();
  std::string cluster_id = instance_id + "-c1";

  google::bigtable::admin::v2::Instance in;
  in.set_type(google::bigtable::admin::v2::Instance::PRODUCTION);
  in.set_display_name("Put description here");

  google::bigtable::admin::v2::Cluster cluster;
  cluster.set_location(Location(project, zone).FullName());
  cluster.set_serve_nodes(3);
  cluster.set_default_storage_type(google::bigtable::admin::v2::HDD);

  std::map<std::string, google::bigtable::admin::v2::Cluster> cluster_map = {
      {cluster_id, std::move(cluster)}};

  future<StatusOr<google::bigtable::admin::v2::Instance>> instance_future =
      instance_admin.CreateInstance(project_name, instance_id, std::move(in),
                                    std::move(cluster_map));
  // Show how to perform additional work while the long running operation
  // completes. The application could use future.then() instead.
  std::cout << "Waiting for instance creation to complete " << std::flush;
  instance_future.wait_for(std::chrono::seconds(1));
  std::cout << '.' << std::flush;
  auto instance = instance_future.get();
  if (!instance) throw std::move(instance).status();
  std::cout << "DONE, details=" << instance->DebugString() << "\n";
}

C#

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

// Creates a production instance with "<intanceId>-prod" instance ID,
// with cluster ID "ssd-cluster1", 3 nodes and location us-east1-b.
displayName += " Prod"; // Display name is for display purposes only. It doesn't have to equal instanceId and can be amended after instance is created.
string instanceId = Regex.Replace(displayName, @"[^A-Za-z0-9_\.~]+", "-").ToLower();

// Please refer to the link below for the full list of available locations:
// https://cloud.google.com/bigtable/docs/locations
string zone1 = "us-east1-b";

// The instance to create.
Instance myInstance = new Instance
{
    DisplayName = displayName,
    // You can choose DEVELOPMENT or PRODUCTION type here.
    // If not set, will default to PRODUCTION type.
    // Instance type can be upgraded from DEVELOPMENT to PRODUCTION but cannot be dowgraded after the instance is created.
    Type = Instance.Types.Type.Production,
    Labels = { { "prod-label", "prod-label" } }
};

// The first cluster to be created within the instance.
Cluster myCluster1 = new Cluster
{
    // You can choose SSD or HDD storage type here: StorageType.Ssd or StorageType.Hdd.
    // Cluster storage type can not be changed after the instance is created.
    // If not set will default to SSD type.
    DefaultStorageType = StorageType.Ssd,
    LocationAsLocationName = new LocationName(projectId, zone1),
    // Serve Nodes count can only be set if PRODUCTION type instance is being created.
    // Minimum count of 3 serve nodes must be specified.
    // Serve Nodes count can be increased and decreased after an instance is created.
    ServeNodes = 3
};

// Initialize request argument(s).
CreateInstanceRequest request = new CreateInstanceRequest
{
    ParentAsProjectName = new ProjectName(projectId),
    Instance = myInstance,
    InstanceId = instanceId,
    // Must specify at lease one cluster.
    // Only PRODUCTION type instance can be created with more than one cluster.
    // Currently all clusters must have the same storage type.
    // Clusters must be set to different locations.
    Clusters = { { "ssd-cluster1", myCluster1 } }
};

try
{
    // Make a request.
    Operation<Instance, CreateInstanceMetadata> createInstanceResponse =
        bigtableInstanceAdminClient.CreateInstance(request);
    Console.WriteLine("Waiting for operation to complete...");

    // Poll until the returned long-running operation is complete
    Operation<Instance, CreateInstanceMetadata> completedResponse =
        createInstanceResponse.PollUntilCompleted();
}
catch (Exception ex)
{
    Console.WriteLine($"Exception while creating {displayName} instance");
    Console.WriteLine(ex.Message);
}

Go

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

// Instance admin is a sample program demonstrating use of the Cloud Bigtable client
// library to perform basic instance admin operations.
package main

import (
	"context"
	"flag"
	"fmt"
	"io"
	"os"

	"cloud.google.com/go/bigtable"
)

func main() {
	projectID := "my-project-id" // The Google Cloud Platform project ID
	instanceID := "my-bigtable-instance"
	clusterID := "my-cluster"
	zone := "us-central1-b"

	// Allow overriding with flags
	flag.StringVar(&projectID, "project", projectID, "The Google Cloud Platform project ID.")
	flag.StringVar(&instanceID, "instance", instanceID, "The Google Cloud Bigtable instance ID to create.")
	flag.StringVar(&zone, "zone", zone, "The zone for the initial cluster.")
	flag.Parse()

	if err := createInstance(os.Stdout, projectID, instanceID, clusterID, zone); err != nil {
		fmt.Fprintf(os.Stderr, "Error creating instance: %v", err)
	}
}

func createInstance(w io.Writer, projectID, instanceID, clusterID, zone string) error {
	ctx := context.Background()

	instanceAdminClient, err := bigtable.NewInstanceAdminClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigtable.NewInstanceAdminClient: %w", err)
	}
	defer instanceAdminClient.Close()

	// These are placeholders. You must create these in your GCP Organization/Project first.
	// See [Creating and managing tags](https://docs.cloud.google.com/bigtable/docs/tags) for
	// more information on creating a tag.
	// tagKey := "tagKeys/12345"
	// tagValue := "tagValues/56789"

	instanceConf := &bigtable.InstanceConf{
		InstanceId:   instanceID,
		DisplayName:  instanceID,
		ClusterId:    clusterID,
		NumNodes:     1,
		InstanceType: bigtable.PRODUCTION,
		StorageType:  bigtable.SSD,
		Zone:         zone,
		// The 'Tags' field is optional. Uncomment the lines below (and the tagKey, tagValue lines above)
		// only if you want to create an instance with tags.
		// Ensure the tagKey and tagValue exist in your GCP project.
		// Tags: map[string]string{tagKey: tagValue},
	}

	fmt.Fprintf(w, "Creating instance %s with cluster %s in %s...\n", instanceID, clusterID, zone)

	if err := instanceAdminClient.CreateInstance(ctx, instanceConf); err != nil {
		return fmt.Errorf("CreateInstance: %w", err)
	}

	fmt.Fprintf(w, "Instance %s created successfully.\n", instanceID)
	return nil
}

Java

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

// Creates a Production Instance with the ID "ssd-instance",
// cluster id "ssd-cluster", 3 nodes and location "us-central1-f".
String parent = "projects/" + projectId;
Instance.Builder instanceObjBuilder =
    Instance.newBuilder()
        .setDisplayName(instanceId)
        .setType(Instance.Type.PRODUCTION)
        .putLabels("department", "accounting");

if (createWithTags) {
  System.out.println("Enabling tags for instance creation.");
  // These are placeholders. You must create these in your GCP Organization/Project first.
  String tagKey = "tagKeys/12345";
  String tagValue = "tagValues/6789";
  instanceObjBuilder.putTags(tagKey, tagValue);
}
Instance instanceObj = instanceObjBuilder.build();

Cluster clusterObj =
    Cluster.newBuilder()
        .setLocation("projects/" + projectId + "/locations/us-central1-f")
        .setServeNodes(3)
        .setDefaultStorageType(StorageType.SSD)
        .build();
CreateInstanceRequest request =
    CreateInstanceRequest.newBuilder()
        .setParent(parent)
        .setInstanceId(instanceId)
        .setInstance(instanceObj)
        .putClusters(clusterId, clusterObj)
        .build();
// Creates a production instance with the given request.
try {
  Instance instance = adminClient.createInstanceAsync(request).get();
  System.out.printf("PRODUCTION type instance %s created successfully%n", instance.getName());
} catch (Exception e) {
  System.err.println("Failed to create instance: " + e.getMessage());
  throw new RuntimeException(e);
}

Node.js

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

// Creates a Production Instance with the ID "ssd-instance"
// with cluster id "ssd-cluster", 3 nodes and location us-central1-f
const {BigtableInstanceAdminClient} = require('@google-cloud/bigtable').v2;
const instanceAdminClient = new BigtableInstanceAdminClient();
const projectId = await instanceAdminClient.getProjectId();

const instanceOptions = {
  parent: `projects/${projectId}`,
  instanceId: instanceID,
  instance: {
    displayName: instanceID,
    labels: {'prod-label': 'prod-label'},
    type: 'PRODUCTION',
  },
  clusters: {
    [clusterID]: {
      location: `projects/${projectId}/locations/us-central1-f`,
      serveNodes: 3,
      defaultStorageType: 'SSD',
    },
  },
};

// Create production instance with given options
const [prodInstance, operation] =
  await instanceAdminClient.createInstance(instanceOptions);
await operation.promise();
console.log(`Created Instance: ${prodInstance.name}`);

PHP

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

use Exception;
use Google\ApiCore\ApiException;
use Google\Cloud\Bigtable\Admin\V2\Client\BigtableInstanceAdminClient;
use Google\Cloud\Bigtable\Admin\V2\Cluster;
use Google\Cloud\Bigtable\Admin\V2\CreateInstanceRequest;
use Google\Cloud\Bigtable\Admin\V2\GetInstanceRequest;
use Google\Cloud\Bigtable\Admin\V2\Instance;
use Google\Cloud\Bigtable\Admin\V2\Instance\Type as InstanceType;
use Google\Cloud\Bigtable\Admin\V2\StorageType;

/**
 * Create a production Bigtable instance
 *
 * @param string $projectId The Google Cloud project ID
 * @param string $instanceId The ID of the Bigtable instance to be generated
 * @param string $clusterId The ID of the cluster to be generated
 * @param string $locationId The Bigtable region ID where you want your instance to reside
 */
function create_production_instance(
    string $projectId,
    string $instanceId,
    string $clusterId,
    string $locationId = 'us-east1-b'
): void {
    $instanceAdminClient = new BigtableInstanceAdminClient();

    $projectName = $instanceAdminClient->projectName($projectId);
    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);

    $serveNodes = 3;
    $storageType = StorageType::SSD;
    $production = InstanceType::PRODUCTION;
    $labels = ['prod-label' => 'prod-label'];

    $instance = new Instance();
    $instance->setDisplayName($instanceId);

    $instance->setLabels($labels);
    $instance->setType($production);

    $cluster = new Cluster();
    $cluster->setDefaultStorageType($storageType);
    $locationName = $instanceAdminClient->locationName($projectId, $locationId);
    $cluster->setLocation($locationName);
    $cluster->setServeNodes($serveNodes);
    $clusters = [
        $clusterId => $cluster
    ];
    try {
        $getInstanceRequest = (new GetInstanceRequest())
            ->setName($instanceName);
        $instanceAdminClient->getInstance($getInstanceRequest);
        printf('Instance %s already exists.' . PHP_EOL, $instanceId);
        throw new Exception(sprintf('Instance %s already exists.' . PHP_EOL, $instanceId));
    } catch (ApiException $e) {
        if ($e->getStatus() === 'NOT_FOUND') {
            printf('Creating an Instance: %s' . PHP_EOL, $instanceId);
            $createInstanceRequest = (new CreateInstanceRequest())
                ->setParent($projectName)
                ->setInstanceId($instanceId)
                ->setInstance($instance)
                ->setClusters($clusters);
            $operationResponse = $instanceAdminClient->createInstance($createInstanceRequest);
            $operationResponse->pollUntilComplete();
            if (!$operationResponse->operationSucceeded()) {
                print('Error: ' . $operationResponse->getError()->getMessage());
            } else {
                printf('Instance %s created.', $instanceId);
            }
        } else {
            throw $e;
        }
    }
}

Python

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

cluster = instance.cluster(
    cluster_id,
    location_id=location_id,
    serve_nodes=serve_nodes,
    default_storage_type=storage_type,
)
if not instance.exists():
    print("\nCreating an instance")
    # Create instance with given options
    operation = instance.create(clusters=[cluster])
    # Ensure the operation completes.
    operation.result(timeout=480)
    print("\nCreated instance: {}".format(instance_id))

Ruby

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal. 

# instance_id      = "my-instance"
# cluster_id       = "my-cluster"
# cluster_location = "us-east1-b"
puts "Creating a PRODUCTION Instance"
job = bigtable.create_instance(
  instance_id,
  display_name: "Sample production instance",
  labels:       { "env": "production" },
  type:         :PRODUCTION # Optional as default type is :PRODUCTION
) do |clusters|
  clusters.add cluster_id, cluster_location, nodes: 3, storage_type: :SSD
end

job.wait_until_done!
instance = job.instance
puts "Created Instance: #{instance.instance_id}"

Langkah berikutnya