1. Visão geral
Neste codelab, vamos demonstrar um método simples e fácil para configurar o AlloyDB.

O que você vai criar
Como parte disso, você vai criar uma instância e um cluster do AlloyDB com um clique e aprender a configurar rapidamente em seus projetos futuros também.
Requisitos
2. Antes de começar
Criar um projeto
- No console do Google Cloud, na página de seletor de projetos, selecione ou crie um projeto do Google Cloud.
- Confira se o faturamento está ativado para seu projeto do Cloud. Saiba como verificar se o faturamento está ativado em um projeto.
- Você vai usar o Cloud Shell, um ambiente de linha de comando executado no Google Cloud. Clique em "Ativar o Cloud Shell" na parte de cima do console do Google Cloud.

- Depois de se conectar ao Cloud Shell, verifique se sua conta já está autenticada e se o projeto está configurado com seu ID do projeto usando o seguinte comando:
gcloud auth list
- Execute o comando a seguir no Cloud Shell para confirmar se o comando gcloud sabe sobre seu projeto.
gcloud config list project
- Se o projeto não estiver definido, use este comando:
gcloud config set project <YOUR_PROJECT_ID>
- Ative as APIs necessárias: siga o link e ative as APIs.
Como alternativa, use o comando gcloud. Consulte a documentação para ver o uso e os comandos gcloud.
3. Por que usar o AlloyDB para seus dados comerciais e IA?
O AlloyDB para PostgreSQL não é apenas mais um serviço gerenciado do Postgres. É uma modernização fundamental do mecanismo projetado para a era da IA. Confira por que ele é diferente dos bancos de dados padrão:
- Processamento transacional e analítico híbrido (HTAP)
A maioria dos bancos de dados exige que você mova os dados para um data warehouse para análise. O AlloyDB tem um mecanismo colunar integrado que mantém automaticamente os dados relevantes em um armazenamento de colunas na memória. Isso torna as consultas analíticas até 100 vezes mais rápidas do que o PostgreSQL padrão, permitindo que você execute Business Intelligence em tempo real nos seus dados operacionais sem pipelines de ETL complexos.
- Integração nativa de IA:
O AlloyDB diminui a distância entre seus dados e a IA generativa. Com a extensão google_ml_integration, é possível chamar modelos da Vertex AI (como o Gemini) diretamente nas suas consultas SQL. Isso significa que você pode realizar análise de sentimentos, tradução ou extração de entidades como uma transação de banco de dados padrão, garantindo a segurança dos dados e minimizando a latência.
- Pesquisa vetorial avançada:
Enquanto o PostgreSQL padrão usa pgvector, o AlloyDB o potencializa com o índice ScaNN (vizinhos mais próximos escalonáveis), desenvolvido pela Google Research. Isso oferece uma pesquisa de similaridade de vetor significativamente mais rápida e um recall maior em escala em comparação com os índices HNSW padrão encontrados em outras ofertas do Postgres. Ele permite criar aplicativos RAG (geração aumentada de recuperação) de alta performance de forma nativa.
- Performance em escala:
O AlloyDB oferece desempenho transacional até quatro vezes mais rápido do que o PostgreSQL padrão. Ele separa a computação do armazenamento, permitindo que eles sejam escalonados de maneira independente. A camada de armazenamento é inteligente e processa o registro de gravação antecipada (WAL) para descarregar o trabalho da instância principal.
- Disponibilidade para empresas:
Ele oferece um SLA de tempo de atividade de 99,99%, incluindo manutenção. Esse nível de confiabilidade para um banco de dados compatível com PostgreSQL é alcançado por uma arquitetura nativa da nuvem que garante recuperação rápida de falhas e durabilidade do armazenamento.
4. Configuração do AlloyDB
Neste laboratório, vamos usar o AlloyDB como banco de dados para os dados de teste. Ele usa clusters para armazenar todos os recursos, como bancos de dados e registros. Cada cluster tem uma instância principal que fornece um ponto de acesso aos dados. As tabelas vão conter os dados reais.
Vamos criar um cluster, uma instância e uma tabela do AlloyDB em que o conjunto de dados de teste será carregado.
- Clique no botão ou copie o link abaixo para o navegador em que o usuário do console do Google Cloud está conectado.
- Depois que essa etapa for concluída, o repositório será clonado no editor local do Cloud Shell, e você poderá executar o comando abaixo na pasta do projeto. É importante verificar se você está no diretório do projeto:
sh run.sh
- Agora use a interface (clique no link no terminal ou no link "visualizar na Web" no terminal).
- Insira os detalhes do ID do projeto, do cluster e dos nomes das instâncias para começar.
- Tome um café enquanto os registros rolam e leia aqui como isso é feito nos bastidores.
5. Configuração ilustrada

6. Limpeza
Depois de concluir este laboratório de teste, não se esqueça de excluir o cluster e a instância do AlloyDB.
Ele vai limpar o cluster e as instâncias dele.
7. Parabéns
Tudo pronto!!!
Comece a configurar seus dados com o AlloyDB de forma rápida e fácil.