Guia de início rápido: criar e se conectar a um banco de dados

Aprenda a criar um banco de dados do Firestore com compatibilidade com o MongoDB e a se conectar a ele com a ferramenta mongosh.

Antes de começar

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Cloud Datastore Owner

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM
    2. Selecionar um projeto.
    3. Clique em CONCEDER ACESSO.

    4. No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

    5. Na lista Selecionar um papel, escolha um.
    6. Para conceder outros papéis, clique em Adicionar outro papel e adicione cada papel adicional.
    7. Clique em Salvar.
  5. Instale a ferramenta mongosh

    6. Criar um banco de dados do Firestore com compatibilidade com o MongoDB e recuperar a string de conexão

    No console Google Cloud , crie um banco de dados da edição Enterprise do Firestore. O Firestore com compatibilidade com o MongoDB exige a edição Enterprise do Firestore:

    1. No console do Google Cloud , acesse a página Bancos de dados.

      Acessar "Bancos de dados"

    2. Clique em Criar um banco de dados do Firestore.
    3. Insira um ID do banco de dados.
    4. Selecione a edição Enterprise.
    5. Selecione um local para o banco de dados.

    6. Clique em Criar banco de dados.

      Quando a inicialização do banco de dados for concluída, o console vai abrir o Firestore Studio para seu banco de dados.

    7. Na seção Conectar-se ao Firestore usando uma ferramenta externa do MongoDB, copie a string de conexão.

      A string de conexão depende do UID do banco de dados (gerado pelo sistema) e da localização dele:

      UID.LOCATION.firestore.goog

    Criar um usuário para autenticação SCRAM

    No console Google Cloud , crie um usuário de banco de dados e atribua a ele permissões do Identity and Access Management.

    1. No console do Google Cloud , acesse a página Bancos de dados.

      Acessar "Bancos de dados"

    2. Selecione o banco de dados na lista.
    3. No menu de navegação, clique em Auth.
    4. Clique em Adicionar usuário.
    5. Digite um nome de usuário.
    6. Selecione uma função do Identity and Access Management para o usuário.
    7. Clique em "Criar". O banco de dados cria um usuário e mostra a senha gerada dele. Copie e salve essa senha. Não será possível recuperar essa senha depois..

    Conectar usando mongosh

    Use a string de conexão, o nome de usuário e a senha para se conectar ao banco de dados e execute mongosh localmente com as seguintes opções de configuração.

    mongosh 'mongodb://USERNAME:PASSWORD@CONNECTION_STRING:443/DATABASE_ID?loadBalanced=true&authMechanism=SCRAM-SHA-256&tls=true&retryWrites=false'

    Substitua:

    • USERNAME: o nome do usuário do banco de dados que você criou.
    • PASSWORD: a senha gerada para o usuário do banco de dados que você criou.
    • CONNECTION_STRING: a string de conexão do banco de dados.
    • DATABASE_ID: um ID do banco de dados

    Depois de conectado, você pode criar e ler dados. Por exemplo:

    db.pages.insertOne({ message: "Hello World!"})
db.pages.find({})
exit

    Limpar

    Para limpar os recursos usados nesta página, exclua o usuário e o banco de dados.

    Excluir o usuário do banco de dados

    Exclua o usuário do banco de dados para remover o usuário e as permissões atribuídas do Identity and Access Management.

    1. No console do Google Cloud , acesse a página Bancos de dados.

      Acessar "Bancos de dados"

    2. Selecione o banco de dados na lista.
    3. No menu de navegação, clique em Auth.
    4. Clique em Ações na coluna Ações do usuário que você quer excluir. Clique em Excluir usuário. Uma caixa de diálogo será exibida.
    5. Confirme a exclusão e clique em Excluir.
    6. Uma caixa de diálogo mostra um link para a página do IAM. Clique no link para excluir as permissões atribuídas ao usuário do banco de dados.

    7. Encontre a linha que contém o principal cujo acesso você quer revogar. Em seguida, clique em Editar principal nessa linha.

      O principal do usuário do banco de dados que você criou usa o seguinte formato de nomenclatura:

      principal://firestore.googleapis.com/projects/PROJECT_NUMBER/name/databases/DATABASE_ID/userCreds/USER_ID
    8. Clique no botão Excluir do papel que você quer revogar e clique em Salvar.

    Excluir o banco de dados

    Siga estas etapas para excluir o banco de dados:

    1. No console do Google Cloud , acesse a página Bancos de dados.

      Acessar "Bancos de dados"

    2. Clique em Ver mais na coluna Ações do banco de dados que você quer excluir. Clique em Excluir. Uma caixa de diálogo será exibida.

    3. Na caixa de diálogo Excluir banco de dados?, confirme a exclusão digitando o ID do banco de dados no campo de texto. Clique em Excluir. O console informa sobre o sucesso ou a falha da operação.

      Se a operação falhar, confira os detalhes do banco de dados e verifique se a proteção contra exclusão está desativada. Para desativar a proteção contra exclusão, consulte Atualizar a configuração de proteção contra exclusão.

    A seguir