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 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

  3. Verify 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. Selecione o 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, adicione-os clicando em Adicionar outro papel.
    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 do 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 seu 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 Google Cloud console, crie um usuário do 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 de bancos de dados.
    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

    A seguir