Início rápido: crie uma base de dados e ligue-se à mesma

Saiba como criar uma base de dados compatível com o Firestore com o MongoDB e estabelecer ligação à mesma 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.

      Aceder ao IAM
    2. Selecione o projeto.
    3. Clique em Conceder acesso.

    4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

    5. Na lista Selecionar uma função, selecione uma função.
    6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
    7. Clique em Guardar.
  5. Instale a ferramenta mongosh

    6. Crie uma base de dados do Firestore com compatibilidade com o MongoDB e obtenha a cadeia de caracteres da ligação

    Na Google Cloud consola, crie uma nova base de dados do Firestore Enterprise Edition. O Firestore com compatibilidade com o MongoDB requer a edição Enterprise do Firestore:

    1. Na Google Cloud consola, aceda à página Bases de dados.

      Aceda a Bases de dados

    2. Clique em Criar uma base de dados do Firestore.
    3. Introduza um ID da base de dados.
    4. Selecione a edição Enterprise.
    5. Selecione uma localização para a base de dados.

    6. Clique em Criar base de dados.

      Quando a base de dados concluir a inicialização, a consola abre o Firestore Studio para a sua base de dados.

    7. Na secção Estabeleça ligação ao Firestore através de uma ferramenta MongoDB externa, copie a string de ligação.

    A string de ligação depende do UID da base de dados (gerado pelo sistema) e da localização da base de dados:

    UID.LOCATION.firestore.goog

    Crie um utilizador para a autenticação SCRAM

    Na Google Cloud consola, crie um novo utilizador da base de dados e atribua-lhe as autorizações de gestão de identidades e acessos.

    1. Na Google Cloud consola, aceda à página Bases de dados.

      Aceda a Bases de dados

    2. Selecione a base de dados na lista de bases de dados.
    3. No menu de navegação, clique em Auth.
    4. Clique em Adicionar utilizador.
    5. Introduza um nome de utilizador.
    6. Selecione uma função de gestão de identidade e acesso para o utilizador.
    7. Clique em Criar. A base de dados cria um utilizador e mostra-lhe a palavra-passe gerada do utilizador. Copie e guarde esta palavra-passe. Não vai poder recuperar esta palavra-passe mais tarde..

    Ligue-se através do mongosh

    Use a cadeia de caracteres de ligação, o nome de utilizador e a palavra-passe para estabelecer ligação à sua base de dados, execute o 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 o seguinte:

    • USERNAME: o nome do utilizador da base de dados que criou.
    • PASSWORD: a palavra-passe gerada para o utilizador da base de dados que criou.
    • CONNECTION_STRING: a string de ligação à base de dados.
    • DATABASE_ID: um ID da base de dados

    Depois de associada, pode criar e ler dados, por exemplo:

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

    O que se segue?