Nesta página, você encontra uma visão geral dos recursos que o Cloud SQL para PostgreSQL oferece para ajudar na criação de aplicativos programados por IA.
O Google AI Studio oferece suporte ao desenvolvimento full-stack assistido por IA, permitindo que você crie aplicativos com funcionalidades avançadas, como repositório de dados persistente e autenticação segura. Usando o modo de criação no Google AI Studio, com um único comando e alguns cliques, é possível criar um aplicativo avançado usando o Cloud SQL para PostgreSQL como banco de dados. Isso permite que seu aplicativo aproveite o poder do PostgreSQL de código aberto e a prontidão empresarial do Cloud SQL.
Introdução ao Google AI Studio e ao Cloud SQL
É possível criar um aplicativo com o Cloud SQL usando o Google AI Studio sem custo financeiro. Para isso, siga as etapas abaixo.
Descreva o aplicativo.
- Abra o Google AI Studio.
- Para abrir o modo de criação, clique em Testar.
Se esta for sua primeira vez usando o Google AI Studio e você ainda não tiver uma conta do Google Cloud , uma janela Bem-vindo ao AI Studio vai aparecer.
Leia os Termos de Serviço adicionais do nível Starter, aceite os termos do contrato e selecione as notificações que você quer receber.
Clique em Continuar.
No campo de comando, insira um comando que descreva seu aplicativo.
Por exemplo, você pode inserir o texto a seguir. Para melhores resultados, peça explicitamente ao agente para usar o Cloud SQL ou um banco de dados relacional:
Build an expense tracker app using Cloud SQLClique em Build.
Para confirmar a criação do Cloud SQL para seu aplicativo, o card Ativar banco de dados aparece no chat do Google AI Studio. É possível usar as configurações padrão de projeto e local do card ou alterá-las.
O projeto e o local escolhidos para o primeiro recurso integrado são aplicados automaticamente a todos os outros serviços e produtos do Google Cloud que você adicionar ao app, incluindo:
Para usar as configurações padrão do Cloud SQL, faça o seguinte:
- No card Ativar banco de dados, clique em Ativar o Cloud SQL.
Para selecionar seu próprio projeto e local de armazenamento de dados, faça o seguinte:
No card Ativar banco de dados, clique em Configurações Configurações.
Na janela Cloud SQL e autenticação que aparece, clique no menu Selecione um projeto do Google Cloud para se conectar ao Cloud SQL.
- Se você tiver uma conta do Google Cloud , selecione Importar projeto para importar um projeto que você já usa. O projeto precisa ter o faturamento ativado. Sujeito às taxas de faturamento padrão.
No menu Seus dados serão armazenados em, escolha a região que você quer usar. Recomendamos escolher uma região geograficamente próxima de você.
Clique em Ativar o Cloud SQL.
O agente implanta automaticamente a instância do Cloud SQL para PostgreSQL, cria o esquema necessário para o aplicativo, conecta o aplicativo à instância e gera o código necessário.
No painel "Visualização", role pelos modelos de design e escolha o que você quer usar. Quando encontrar o que você quer, clique em Selecionar este design.
No painel de conversa do Gemini, clique em arrow_upward Enviar comando.
Iterar no aplicativo.
Depois que a versão inicial do aplicativo for criada, você poderá fazer modificações no app, como adicionar novos recursos, usando comandos. Veja um exemplo:
I want to add a custom description for each expenseO agente faz automaticamente as mudanças necessárias no código e atualiza o esquema para adicionar as colunas necessárias ao banco de dados do Cloud SQL.
Opcional: ao lado do texto Sem título, clique em editar Editar nome e descrição do app para renomear o app. Como alternativa, você pode dar um comando ao Google AI Studio para renomear o app.
Publique o aplicativo.
Quando o aplicativo estiver pronto, clique em Publicar.
No painel Publicar seu app, insira uma descrição para o aplicativo e um e-mail de suporte para que os usuários entrem em contato com você.
Clique em Publicar seu app para implantar o aplicativo usando o Cloud Run.
Entender a cota do Cloud SQL para o Google AI Studio
Usuários novos e qualificados do Google AI Studio podem começar com o nível Starter, uma oferta do Google que dá acesso a um conjunto de atributos em destaque sem exigir uma forma de pagamento.
Com esse nível, é possível criar e implantar apps usando o conjunto selecionado de Google Cloud e serviços do Google (oferecidos com funcionalidades e cotas limitadas). Para saber os requisitos de qualificação da conta, consulte Qualificação para o nível Starter.
A implantação de um app com o Cloud SQL no nível Starter provisiona automaticamente toda a infraestrutura necessária em um projeto totalmente gerenciado do nível Starter.
Como o Google lida com o gerenciamento e a configuração do projeto, é possível usar esses serviços sem uma conta de faturamento.
No nível Starter, os usuários podem desenvolver e publicar dois aplicativos com o Cloud SQL.
Para expandir os limites de recursos e criar mais aplicativos com o Cloud SQL, faça upgrade do seu projeto do nível Starter para um projeto padrão Google Cloud .
Um projeto padrão do Google Cloud aceita até 10 aplicativos com o Cloud SQL por usuário por região.
É possível escalonar verticalmente sua instância do Cloud SQL depois de fazer upgrade para um projeto padrão do Google Cloud .
Configuração do Cloud SQL no nível Starter
Quando o Google AI Studio cria um aplicativo que precisa de um banco de dados relacional no nível Starter, o agente cria uma instância do Cloud SQL para PostgreSQL Developer Edition.
As instâncias da edição para desenvolvedores oferecem os seguintes recursos:
- Suporta 0,5 vCPU e 2 GB de memória com 1 GB de armazenamento.
- Cria instâncias em um projeto de nível Starter totalmente gerenciado.
- Oferece suporte a instâncias do Cloud SQL para PostgreSQL criadas na versão PostgreSQL 18.
Configuração do Cloud SQL ao usar um projeto atual
Se você tiver uma conta do Google Cloud e ativar a integração do Cloud SQL para um aplicativo, poderá selecionar um projeto doGoogle Cloud que você possui:
No card Ativar banco de dados, clique em Configurações Configurações.
Na janela Cloud SQL e autenticação que aparece, clique no menu Selecione um projeto do Google Cloud para se conectar ao Cloud SQL.
- Selecione Importar projeto para importar um projeto que você já usa. O faturamento precisa estar ativado no projeto.
Clique em Ativar o Cloud SQL.
Quando você escolhe um projeto, as seguintes ações ocorrem:
- Uma nova instância da edição para desenvolvedores do Cloud SQL para PostgreSQL é provisionada instantaneamente nesse projeto.
- A instância usa uma cota mensal limitada sem custo financeiro. Qualquer uso excedente é cobrado de acordo com as cobranças de computação e armazenamento. Para mais informações, consulte Nível Starter e preços.
A edição para desenvolvedores do Cloud SQL para PostgreSQL só pode ser criada ao usar o Google AI Studio. Não é possível criar uma instância da edição para desenvolvedores no Google Cloud console ou usando a API Cloud SQL Admin, a CLI gcloud ou o Terraform. A instância da edição Developer do Cloud SQL para PostgreSQL vem com os seguintes recursos:
- Nível Starter para começar a criar aplicativos sem custo financeiro.
- Ao usar seu projeto do Google Cloud para criar e implantar aplicativos do Google AI Studio com o Cloud SQL, você recebe 50 unidades de computação e 10 GB do Cloud Storage por mês por conta de faturamento sem custos financeiros. Para mais informações, consulte Nível Starter e preços.
- Provisionamento instantâneo para uma experiência de vibe coding
perfeita.
- A instância do Cloud SQL é provisionada em segundos e fica pronta para o Google AI Studio criar o aplicativo.
- Pausa a instância do banco de dados automaticamente quando o aplicativo está inativo.
- O recurso "redução da escala a zero" pausa uma instância automaticamente quando não há conexões ativas. As instâncias pausadas não acumulam custos de VM ou armazenamento. Sujeito a limitações de capacidade da instância.
- Escalone até 2 vCPUs, 8 GB de RAM e 20 GB de armazenamento.
- À medida que as necessidades de computação e armazenamento do aplicativo aumentam, é possível atualizar a instância para uma configuração de 1 vCPU e 4 GB ou 2 vCPUs e 8 GB. Também é possível atualizar o armazenamento para até 20 GB.
Só é possível fazer upgrade de uma instância quando ela está em um projeto padrão do Google Cloud . Não é possível escalonar verticalmente uma instância usando o nível Starter.
Para mais informações, consulte Fazer upgrade do projeto do nível Starter para um projeto padrão do Google Cloud .
Operações na instância
Quando um aplicativo do Google AI Studio usa uma instância do Cloud SQL como banco de dados, é possível interagir com a instância no Google AI Studio usando comandos de linguagem natural. Por exemplo, se você quiser ver o esquema, pergunte ao agente o seguinte:
Show me the schema in the database.
O agente retorna todas as informações sobre o esquema.
Da mesma forma, se você quiser executar uma operação CRUD no banco de dados, por exemplo,
para inserir linhas, peça ao agente para executar essa operação.
Faça upgrade do nível Starter para ter mais cota e recursos
Depois de implantar o app usando o Google AI Studio, você pode aumentar a cota da sua instância do Cloud SQL e acessar outros serviços do Google Cloud fazendo upgrade de um projeto do nível Starter para um projeto padrão do Google Cloud .
Para fazer upgrade do seu projeto do nível Starter para um projeto padrão do Google Cloud :
- No Google AI Studio, clique em Configurações Configurações.
- Na janela Configurações do chat que aparece, na seção Solicitações sem custo financeiro, clique em Configurações Selecionar uma chave de API.
- Na janela Faça upgrade para desbloquear mais recursos, clique em API Gemini.
- Clique em Continuar com o pagamento por solicitação.
- Na janela Vincular uma chave de API paga, clique em Configurar faturamento.
- Na janela Configurar sua conta de faturamento do Google Cloud, leia os Termos de Serviço do Google Cloud faturamento e clique em Concordar e continuar.
- Na janela Adicionar os detalhes da sua conta de faturamento, insira seus dados de contato e forma de pagamento e clique em Enviar.
Agora você pode receber cotas maiores para seus serviços de aplicativo. Para mais informações, consulte Entender a cota do Cloud SQL para o Google AI Studio.
Atualizar a instância do Cloud SQL
Depois de fazer upgrade para um projeto padrão do Google Cloud , use o console doGoogle Cloud para aumentar o tamanho da instância atualizando a vCPU e o tamanho do disco da instância do Cloud SQL.
Para atualizar a instância do Cloud SQL no console do Google Cloud :
-
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral da instância, clique no nome dela. Qualquer instância criada usando o Google AI Studio tem o tipo de edição do Cloud SQL listado como Developer e um prefixo de ID de instância de ai-studio-.
- Clique em Editar.
No painel ID da instância, atualize as configurações:
- Configuração da máquina: selecione a vCPU e a quantidade de RAM que você quer usar.
- Armazenamento: selecione a quantidade de armazenamento que você quer usar.
Para mais informações, consulte Configurações editáveis.
Clique em Salvar.
Nível Starter e preços
A edição para desenvolvedores do Cloud SQL para PostgreSQL é cobrada apenas pelo uso que excede o nível Starter e pelo tempo em que a instância está em execução. A instância não é cobrada quando está inativa ou "reduzida a zero".
A edição para desenvolvedores do Cloud SQL é cobrada com base em unidades de computação. Uma unidade de computação refere-se a 1 vCPU e 4 GB de memória. Você recebe 50 unidades de computação e 10 GB de armazenamento sem custos financeiros todo mês.
O uso do nível Starter é agregado em todos os projetos doGoogle Cloud por conta do Cloud Billing e é redefinido todo mês. Você só recebe cobranças pelo uso que ultrapassar o nível sem custo financeiro limitado.
Se você estiver implantando aplicativos usando o Cloud SQL em vários projetos do Google Cloud e todos os projetos usarem a mesma conta de faturamento, o limite de uso será agregado em todos os projetos.
Preços de computação e armazenamento
Veja a seguir um exemplo de preço por unidade na região da Carolina do Sul
(us-east1).
| Preços por hora | |
|---|---|
Carolina do Sul (us-east1) |
Região (USD) |
| Unidade de computação | US$ 0,10 / 1 hora |
| Armazenamento | US$ 0,000157534 / 1 gibibyte por hora |
Para informações detalhadas sobre preços, consulte Preços do Cloud SQL.
Exemplo do nível Starter
Se você tiver uma conta do Google , poderá começar a usar o Google AI Studio com a cota limitada sem custo financeiro do Cloud SQL no nível Starter.
É possível criar dois aplicativos sem custos financeiros usando o nível Starter. Depois que essa cota for excedida, você poderá fazer upgrade para um projeto padrão do Google Cloud e receber mais cota para criar e publicar outros apps do Google AI Studio.
Se você fizer upgrade do seu projeto do nível Starter para um projeto padrão do Google Cloud ou criar um projeto padrão do Google Cloud para conhecer outros produtos do Google Cloud, poderá usar o Google Cloud teste sem custo financeiro para acessar uma cota limitada de 50 unidades de computação e 10 GB de armazenamento por mês. Se o uso exceder essa cota durante o mês para uma conta de faturamento específica, você vai receber uma cobrança pelo uso extra com base na tabela de preços anterior.
Por exemplo, digamos que você esteja criando aplicativos do Google AI Studio em um projeto do Google Cloud
chamado Test. Você usa uma conta de faturamento e um cartão de crédito para esse projeto. Seu
uso do Cloud SQL no Google AI Studio em todos os aplicativos excede 50
unidades de computação e, até o final do mês, você usa 100 unidades de computação. Você vai receber uma cobrança pelas 50 unidades de computação excedentes a US $0,10 por hora e uma cobrança de US $5 pelo mês.
Limitações
As instâncias de banco de dados com até 1 GB de armazenamento e até 0,5 vCPU de capacidade de computação são pausadas automaticamente ou "reduzidas a zero" se não houver conexões ativas. Esse recurso não é compatível com instâncias que excedem esses limites de armazenamento e computação.
A capacidade de integração com o Google AI Studio poderá ser bloqueada se a organização tiver o compartilhamento restrito de domínio ativado.