Crie um cluster de base de dados

Esta página descreve como usar o serviço de base de dados para criar e gerir bases de dados no Google Distributed Cloud (GDC) air-gapped.

Autorização e funções

Os utilizadores têm de ter autorização para aceder ao serviço de base de dados. É necessária autorização para aceder ao serviço de base de dados com a consola do GDC e a CLI do Distributed Cloud.

As seguintes funções concedem autorizações aos utilizadores:

Visualizador de projetos (project-viewer): Os utilizadores com esta função podem aceder à consola do GDC.
Visualizador de BD de projetos(project-db-viewer): Os utilizadores com esta função podem ver clusters de bases de dados.
Editor de BD de projetos (project-db-editor): Os utilizadores com esta função têm as capacidades conferidas por project-db-viewer e também podem editar clusters de bases de dados.
Administrador da base de dados do projeto (project-db-admin): Os utilizadores com esta função têm a capacidade conferida por project-db-editor e também podem criar e eliminar clusters de bases de dados.
Project Bucket Object Viewer (project-bucket-object-viewer): Os utilizadores com esta função podem usar o explorador de armazenamento na interface do serviço de base de dados na consola do GDC. Esta interface é usada para especificar ficheiros para importações de bases de dados e para especificar destinos para ficheiros gerados por exportações de bases de dados.

Leitor de monitorização de projetos (project-monitoring-viewer): Os utilizadores com esta função podem aceder à instância de monitorização. Consulte o artigo Observe métricas para ver mais informações sobre a observação de métricas do serviço de base de dados. Só deve conceder esta função aos utilizadores que precisam de aceder à instância de monitorização.

Administrador da política de manutenção do projeto (project-mp-admin): Os utilizadores com esta função têm as capacidades conferidas pelas funções project_mp_editor e project_mpb_editor, pelo que podem criar, editar e eliminar políticas de manutenção e associações de políticas de manutenção.
Visualizador da política de manutenção de projetos (project-mp-viewer): Os utilizadores com esta função podem ver políticas de manutenção.
Editor de políticas de manutenção de projetos (project-mp-editor): Os utilizadores com esta função têm as capacidades conferidas pela função project_mp_viewer e também podem criar, editar e eliminar políticas de manutenção.
Project Maintenance Policy Binding Viewer (project-mpb-viewer): Os utilizadores com esta função podem ver associações de políticas de manutenção.
Editor de associação de políticas de manutenção de projetos (project-mpb-editor): Os utilizadores com esta função têm as capacidades conferidas pela função project_mpb_viewer e também podem criar, editar e eliminar associações de políticas de manutenção.

Motores de base de dados disponíveis

Os seguintes motores de base de dados estão disponíveis para utilização num ambiente do GDC:

Bases de dados	Versões
AlloyDB Omni	15
Oracle	19
PostgreSQL	13, 14 e 15

Escolha um tipo de motor de base de dados e crie um cluster de base de dados

Um utilizador com a função de administrador da base de dados do projeto tem de realizar os seguintes passos. Use a consola do GDC ou a CLI do Distributed Cloud para criar clusters de base de dados:

Consola

No menu principal, escolha Serviço de base de dados.
Clique em Criar cluster de base de dados.
Na caixa de diálogo Escolha um motor de base de dados, escolha um motor de base de dados.

Nota: para ver instruções sobre como carregar uma imagem da base de dados Oracle, consulte o artigo Distribua imagens Oracle no Google Distributed Cloud com isolamento de ar.
Na caixa de diálogo Configure o cluster, especifique o ID do cluster, a palavra-passe e a versão da base de dados. Pode ativar as cópias de segurança e configurar o período de retenção das cópias de segurança.
Se escolheu o motor de base de dados PostgreSQL, pode ativar a alta disponibilidade para o cluster de base de dados. Se estiver ativado, o serviço de base de dados aprovisiona uma instância de espera na mesma zona que a sua instância principal para proteção contra falhas. Consulte o artigo Alta disponibilidade para mais informações.
Na caixa de diálogo Configure a sua instância principal, especifique a CPU, a memória e a capacidade de armazenamento da instância principal do cluster da base de dados. Recomendamos que escolha memória suficiente para armazenar a sua maior tabela.
Clique em Criar. A criação do cluster de base de dados pode demorar alguns minutos. Verifique o estado do cluster na página Vista geral do cluster. O estado é alterado de A criar para Pronto quando o cluster está pronto.

gdcloud

Antes de usar a Distributed Cloud CLI, instale-a e inicialize-a. Em seguida, autentique-se junto da sua organização.
Execute o seguinte comando para criar um cluster de base de dados:
```
gdcloud database clusters create CLUSTER_NAME \
    --database-version DB_VERSION \
    --admin-password ADMIN_PASSWORD
```
Substitua as seguintes variáveis:
- CLUSTER_NAME com o nome do novo cluster.
- DB_VERSION com a string da versão do novo cluster. Por exemplo, POSTGRESQL_13, ORACLE_19_ENTERPRISE ou ALLOYDBOMNI_15
- ADMIN_PASSWORD com a palavra-passe de administrador para o novo cluster.
Para mais informações sobre a configuração dos recursos de CPU, memória e armazenamento para o cluster de base de dados, a configuração da cópia de segurança, a ativação da elevada disponibilidade e outras opções disponíveis, execute o seguinte comando:
```
gdcloud database clusters create --help
```

API

Para bases de dados AlloyDB ou PostgreSQL:

apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DBCLUSTER_NAME
  namespace: USER_PROJECT
type: Opaque
data:
  DBCLUSTER_NAME: "BASE64_PASSWORD"
---
apiVersion: DBENGINE_NAME.dbadmin.gdc.goog/v1
kind: DBCluster
metadata:
  name: DBCLUSTER_NAME
  namespace: USER_PROJECT
spec:
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DBCLUSTER_NAME
    version: "DB_VERSION"
    resources:
      memory: DB_MEMORY
      cpu: DB_CPU
      disks:
      - name: DataDisk
        size: DB_DATA_DISK

Para bases de dados Oracle:

apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DBCLUSTER_NAME
  namespace: USER_PROJECT
type: Opaque
data:
  DBCLUSTER_NAME: "BASE64_PASSWORD"
---
apiVersion: oracle.dbadmin.gdc.goog/v1
kind: DBCluster
metadata:
  name: DBCLUSTER_NAME
  namespace: USER_PROJECT
spec:
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DBCLUSTER_NAME
    version: "DB_VERSION"
    cdbName: GCLOUD
    resources:
      memory: DB_MEMORY
      cpu: DB_CPU
      disks:
      - name: DataDisk
        size: DB_DATA_DISK
      - name: LogDisk
        size: DB_LOG_DISK

Substitua as seguintes variáveis:

DBCLUSTER_NAME, o nome do cluster da base de dados.
USER_PROJECT, o nome do projeto do utilizador onde o cluster de base de dados vai ser criado.
BASE64_PASSWORD, a codificação base64 da palavra-passe do administrador da base de dados.
DBENGINE_NAME, o nome do motor da base de dados. Esta é uma das opções alloydbomni ou postgresql.
DB_VERSION, a versão do motor da base de dados.
DB_MEMORY, a quantidade de memória alocada ao cluster de BD, por exemplo, 5Gi.
DB_CPU, a quantidade de CPUs atribuídas ao cluster de BD, por exemplo, 2.
DB_DATA_DISK, quantidade de espaço atribuído ao cluster de BD, por exemplo, 10 Gi.
DB_LOG_DISK, a quantidade de espaço atribuída ao disco de registo da base de dados do Oracle (apenas para o Oracle).

Crie um recurso BackupPlanDBS no mesmo espaço de nomes para ativar as cópias de segurança.