앱 프로필 구성

이 페이지에서는 Cloud Bigtable 인스턴스의 애플리케이션 프로필 또는 앱 프로필을 만들고 관리하는 방법에 대해 설명합니다. 또한 커스텀 앱 프로필을 사용하여 Cloud Bigtable에 연결하는 방법을 보여줍니다.

이 페이지를 읽기 전에 앱 프로필의 의미와 작동 방식을 이해해야 합니다. 앱 프로필을 사용하여 복제를 구성하는 경우 Cloud Bigtable 복제 개요를 숙지하고 복제 설정 예시를 검토하여 사용 사례에 가장 적합한 설정을 결정해야 합니다.

커스텀 앱 프로필 만들기

인스턴스마다 다양한 커스텀 앱 프로필을 여러 개 만들 수 있습니다. 커스텀 앱 프로필을 사용하여 각 애플리케이션이나 애플리케이션 내의 각 고유 기능이 인스턴스와 상호작용하는 방법을 제어합니다. 예를 들어 배치 애플리케이션에 한 앱 프로필을 사용하여 트래픽을 단일 클러스터로 격리하고, 다른 앱 프로필을 사용하여 또 다른 애플리케이션에 고가용성을 제공할 수 있습니다.

커스텀 앱 프로필을 만들려면 다음 단계를 따르세요.

Console

Cloud Console에서 Cloud Bigtable 인스턴스 목록을 엽니다.

인스턴스 목록 열기
앱 프로필을 만들 인스턴스를 클릭합니다.
왼쪽 창에서 애플리케이션 프로필을 클릭합니다.
애플리케이션 프로필 만들기를 클릭합니다.
애플리케이션 프로필 ID를 입력합니다.

애플리케이션 프로필 ID는 앱 프로필의 영구 식별자입니다. 애플리케이션에서 Cloud Bigtable에 연결 시 이 ID를 제공합니다.
앱 프로필에 대한 설명을 입력합니다.
클러스터 라우팅 아래에서 클러스터 ID를 선택하여 단일 클러스터 라우팅을 사용하거나, 모든 클러스터를 선택하여 멀티 클러스터 라우팅을 사용합니다. 자세히 알아보기
단일 행 트랜잭션을 사용 설정해야 하는 경우 단일 행 트랜잭션 아래에서 단일 행 트랜잭션 허용 체크박스를 선택합니다. 자세히 알아보기

단일 행 트랜잭션을 사용 설정하려면 단일 클러스터 라우팅을 사용해야 합니다.
만들기를 클릭하여 앱 프로필을 만듭니다.
새 앱 프로필을 사용하도록 Cloud Bigtable에 연결하는 애플리케이션의 코드를 업데이트합니다.

gcloud

인스턴스 ID를 모르면 bigtable instances list 명령어를 사용하여 프로젝트 인스턴스 목록을 확인합니다.
```
gcloud bigtable instances list
```
bigtable app-profiles create 명령어를 사용하여 앱 프로필을 만듭니다.
```
gcloud bigtable app-profiles create APP_PROFILE_ID \
    --instance=INSTANCE_ID \
    [--description=DESCRIPTION] \
    [--force] \
    [--route-any] \
    [--route-to=CLUSTER_ID] \
    [--transactional-writes]
```
다음 값을 제공합니다.
- APP_PROFILE_ID: 앱 프로필의 영구 식별자입니다.
- INSTANCE_ID: 인스턴스의 영구 식별자입니다.
이 명령어에는 다음과 같은 선택적 플래그가 사용됩니다.
- --description=DESCRIPTION: 앱 프로필에 대한 자세한 설명입니다.
- --force: 잠재적 문제와 다른 앱 프로필과의 충돌에 대한 경고를 무시합니다.
- --route-any: 멀티 클러스터 라우팅을 사용 설정하여 요청을 사용 가능한 모든 클러스터로 라우팅합니다.
  
  이 플래그를 --route-to 또는 --transactional-writes 플래그와 결합할 수 없습니다.
- --route-to=CLUSTER_ID: 모든 요청이 라우팅되어야 하는 클러스터 ID입니다. 이 플래그는 단일 클러스터 라우팅을 사용 설정합니다.
  
  이 플래그를 --route-any 플래그와 결합할 수 없습니다.
- --transactional-writes: 앱 프로필에서 단일 행 트랜잭션을 사용 설정합니다.
  
  이 플래그를 --route-any 플래그와 결합할 수 없습니다.
새 앱 프로필을 사용하도록 Cloud Bigtable에 연결하는 애플리케이션의 코드를 업데이트합니다.

커스텀 앱 프로필 연결

커스텀 앱 프로필을 만든 후에는 Cloud Bigtable에 연결할 때 애플리케이션에서 커스텀 앱 프로필을 사용하도록 코드를 업데이트할 수 있습니다.

다음 예시는 앱이 Cloud Bigtable 클라이언트를 만들고 인스턴스에 연결할 때 앱 프로필을 지정하는 방법을 보여줍니다. [APP_PROFILE_ID]를 적절한 값으로 바꿉니다.

C#

var client = BigtableClient.Create(appProfileId: "[APP_PROFILE_ID]");

Go

clientConf := bigtable.ClientConfig{AppProfile:"[APP_PROFILE_ID]"}
client, err = bigtable.NewClientWithConfig(ctx, project, instance, clientConf)

HappyBase

HappyBase 클라이언트 라이브러리는 커스텀 앱 프로필을 지원하지 않습니다. 이 클라이언트 라이브러리는 항상 기본 앱 프로필을 사용합니다.

HBase 자바

// If using BigtableOptions directly:
optionsBuilder.setAppProfileId("[APP_PROFILE_ID]");

// If using BigtableOptionsFactory:
configuration.set(BigtableOptionsFactory.APP_PROFILE_ID_KEY, "[APP_PROFILE_ID]");

// If using system properties, set "google.bigtable.app_profile.id" to
// "[APP_PROFILE_ID]"

// If using CloudBigtableIO for Cloud Dataflow:
config.withConfiguration(BigtableOptionsFactory.APP_PROFILE_ID_KEY,
                         "[APP_PROFILE_ID]");

Node.js

const bigtable = new Bigtable({appProfileId: '[APP_PROFILE_ID]'});

Python

from google.cloud import bigtable

client = bigtable.Client(project=project_id)
instance = client.instance(instance_id)
table = bigtable.table.Table(table_id, instance, '[APP_PROFILE_ID]')

앱 프로필 업데이트하기

언제든지 인스턴스의 앱 프로필을 보고 관련 설정을 업데이트할 수 있습니다. Cloud Bigtable은 예기치 않은 동작 변경을 일으킬 수 있는 업데이트를 경고합니다.

기존 앱 프로필을 보거나 업데이트하려면 다음 안내를 따르세요.

Console

Cloud Console에서 Cloud Bigtable 인스턴스 목록을 엽니다.

인스턴스 목록 열기
애플리케이션 프로필 열에서 보거나 업데이트하려는 앱 프로필을 클릭합니다.

편집하려는 앱 프로필이 보이지 않으면 인스턴스 이름을 클릭한 다음 왼쪽 창에서 애플리케이션 프로필을 클릭하여 전체 목록을 볼 수 있습니다.
필요에 따라 설정을 업데이트한 다음 저장을 클릭하거나 취소를 클릭하여 저장하지 않고 종료합니다.

gcloud

인스턴스 ID를 모르면 bigtable instances list 명령어를 사용하여 프로젝트 인스턴스 목록을 확인합니다.
```
gcloud bigtable instances list
```
앱 프로필 ID를 모르면 bigtable app-profiles list 명령어를 사용하여 인스턴스의 앱 프로필 목록을 확인합니다.
```
gcloud bigtable app-profiles list --instance=INSTANCE_ID
```
INSTANCE_ID를 인스턴스의 영구 식별자로 바꿉니다.
(선택사항) bigtable app-profiles describe 명령어를 사용하여 앱 프로필 설정을 확인합니다.
```
gcloud bigtable app-profiles describe APP_PROFILE_ID \
    --instance=INSTANCE_ID
```
다음 값을 제공합니다.
- APP_PROFILE_ID: 앱 프로필의 영구 식별자입니다.
- INSTANCE_ID: 인스턴스의 영구 식별자입니다.
bigtable app-profiles update 명령어를 사용하여 앱 프로필 설정을 업데이트합니다.
```
gcloud bigtable app-profiles update APP_PROFILE_ID \
    --instance=INSTANCE_ID \
    [--description=DESCRIPTION] \
    [--force] \
    [--route-any] \
    [--route-to=CLUSTER_ID] \
    [--transactional-writes]
```
다음 값을 제공합니다.
- APP_PROFILE_ID: 앱 프로필의 영구 식별자입니다.
- INSTANCE_ID: 인스턴스의 영구 식별자입니다.
이 명령어에는 다음과 같은 선택적 플래그가 사용됩니다.
- --description=DESCRIPTION: 앱 프로필에 대한 자세한 설명입니다.
- --force: 잠재적 문제와 다른 앱 프로필과의 충돌에 대한 경고를 무시합니다.
- --route-any: 멀티 클러스터 라우팅을 사용 설정하여 요청을 사용 가능한 모든 클러스터로 라우팅합니다.
  
  이 플래그를 --route-to 또는 --transactional-writes 플래그와 결합할 수 없습니다.
- --route-to=CLUSTER_ID: 모든 요청이 라우팅되어야 하는 클러스터 ID입니다. 이 플래그는 단일 클러스터 라우팅을 사용 설정합니다.
  
  이 플래그를 --route-any 플래그와 결합할 수 없습니다.
- --transactional-writes: 앱 프로필에서 단일 행 트랜잭션을 사용 설정합니다.
  
  이 플래그를 --route-any 플래그와 결합할 수 없습니다.

커스텀 앱 프로필 삭제하기

인스턴스의 커스텀 앱 프로필을 삭제할 수 있지만 기본 앱 프로필은 삭제할 수 없습니다.

커스텀 앱 프로필을 삭제하려면 다음 안내를 따르세요.

Console

Cloud Console에서 Cloud Bigtable 인스턴스 목록을 엽니다.

인스턴스 목록 열기
삭제하려는 앱 프로필이 들어 있는 인스턴스를 클릭합니다.
왼쪽 창에서 애플리케이션 프로필을 클릭합니다.
작업 더보기 메뉴 을 열고 애플리케이션 프로필 삭제를 클릭합니다. 확인 대화상자가 나타납니다.
확인 대화상자의 지침을 따르고 삭제를 클릭합니다.

gcloud

인스턴스 ID를 모르면 bigtable instances list 명령어를 사용하여 프로젝트 인스턴스 목록을 확인합니다.
```
gcloud bigtable instances list
```
앱 프로필 ID를 모르면 bigtable app-profiles list 명령어를 사용하여 인스턴스의 앱 프로필 목록을 확인합니다.
```
gcloud bigtable app-profiles list --instance=INSTANCE_ID
```
INSTANCE_ID를 인스턴스의 영구 식별자로 바꿉니다.
bigtable app-profiles delete 명령어를 사용하여 앱 프로필을 삭제합니다.
```
gcloud bigtable app-profiles delete APP_PROFILE_ID \
    --instance=INSTANCE_ID \
    [--force]
```
다음 값을 제공합니다.
- APP_PROFILE_ID: 앱 프로필의 영구 식별자입니다.
- INSTANCE_ID: 인스턴스의 영구 식별자입니다.
이 명령어에는 다음과 같은 선택적 플래그가 사용됩니다.

--force: 잠재적 문제와 다른 앱 프로필과의 충돌에 대한 경고를 무시합니다.