빠른 시작: 데이터베이스 만들기 및 연결

MongoDB 호환성을 갖춘 Firestore 데이터베이스를 만들고 mongosh 도구로 연결하는 방법을 알아봅니다.

시작하기 전에

  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: roles/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.

      IAM으로 이동
    2. 프로젝트를 선택합니다.
    3. 액세스 권한 부여를 클릭합니다.

    4. 새 주 구성원 필드에 사용자 식별자를 입력합니다. 일반적으로 Google 계정의 이메일 주소입니다.

    5. 역할 선택 목록에서 역할을 선택합니다.
    6. 역할을 추가로 부여하려면 다른 역할 추가를 클릭하고 각 역할을 추가합니다.
    7. 저장을 클릭합니다.
  5. mongosh 도구 설치

MongoDB 호환성을 갖춘 Firestore 데이터베이스 만들기 및 연결 문자열 검색

Google Cloud 콘솔에서 새 Firestore Enterprise 버전 데이터베이스를 만듭니다. MongoDB 호환성을 갖춘 Firestore를 사용하려면 Firestore Enterprise 버전이 필요합니다.

  1. Google Cloud 콘솔에서 데이터베이스 페이지로 이동합니다.

    데이터베이스로 이동

  2. Firestore 데이터베이스 만들기를 클릭합니다.
  3. 데이터베이스 ID를 입력합니다.
  4. Enterprise 버전을 선택합니다.
  5. 데이터베이스의 위치를 선택합니다.

  6. 데이터베이스 만들기를 클릭합니다.

    데이터베이스 초기화가 완료되면 콘솔에서 데이터베이스의 Firestore 스튜디오를 엽니다.

  7. 외부 MongoDB 도구를 사용하여 Firestore에 연결 섹션에서 연결 문자열을 복사합니다.

    연결 문자열은 데이터베이스의 UID (시스템 생성) 및 데이터베이스 위치에 따라 다릅니다.

    UID.LOCATION.firestore.goog

SCRAM 인증 사용자 만들기

Google Cloud 콘솔에서 새 데이터베이스 사용자를 만들고 사용자 Identity and Access Management 권한을 할당합니다.

  1. Google Cloud 콘솔에서 데이터베이스 페이지로 이동합니다.

    데이터베이스로 이동

  2. 데이터베이스 목록에서 데이터베이스를 선택합니다.
  3. 탐색 메뉴에서 인증을 클릭합니다.
  4. Add User(사용자 추가)를 클릭합니다.
  5. 사용자 이름을 입력합니다.
  6. 사용자의 Identity and Access Management 역할을 선택합니다.
  7. 만들기를 클릭합니다. 데이터베이스에서 사용자를 만들고 생성된 사용자 비밀번호를 표시합니다. 이 비밀번호를 복사하여 저장합니다. 나중에 이 비밀번호를 가져올 수 없습니다.

mongosh을 사용하여 연결

연결 문자열, 사용자 이름, 비밀번호를 사용하여 데이터베이스에 연결하고 다음 구성 옵션으로 mongosh를 로컬에서 실행합니다.

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

다음을 바꿉니다.

  • USERNAME: 생성한 데이터베이스 사용자의 이름입니다.
  • PASSWORD: 생성된 데이터베이스 사용자의 비밀번호입니다.
  • CONNECTION_STRING: 데이터베이스 연결 문자열입니다.
  • DATABASE_ID: 데이터베이스 ID

연결되면 다음과 같이 데이터를 만들고 읽을 수 있습니다.

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

삭제

이 페이지에서 사용된 리소스를 정리하려면 데이터베이스 사용자를 삭제하고 데이터베이스를 삭제합니다.

데이터베이스 사용자 삭제

데이터베이스 사용자를 삭제하여 사용자와 할당된 Identity and Access Management 권한을 삭제합니다.

  1. Google Cloud 콘솔에서 데이터베이스 페이지로 이동합니다.

    데이터베이스로 이동

  2. 데이터베이스 목록에서 데이터베이스를 선택합니다.
  3. 탐색 메뉴에서 인증을 클릭합니다.
  4. 삭제하려는 사용자의 작업 열에서 작업을 클릭합니다. 사용자 삭제를 클릭합니다. 대화상자가 나타납니다.
  5. 삭제를 확인하고 삭제를 클릭합니다.
  6. IAM 페이지 링크가 대화상자에 표시됩니다. 링크를 클릭하여 데이터베이스 사용자에게 할당된 권한을 삭제합니다.

  7. 액세스 권한을 취소하려는 주 구성원이 포함된 행을 찾으세요. 그런 다음 이 행에서 주 구성원 수정을 클릭합니다.

    만든 데이터베이스 사용자의 주 구성원은 다음 이름 지정 형식을 사용합니다.

    principal://firestore.googleapis.com/projects/PROJECT_NUMBER/name/databases/DATABASE_ID/userCreds/USER_ID
  8. 취소하려는 역할의 삭제 버튼을 클릭한 다음 저장을 클릭합니다.

데이터베이스 삭제

데이터베이스를 삭제하려면 다음 단계를 완료하세요.

  1. Google Cloud 콘솔에서 데이터베이스 페이지로 이동합니다.

    데이터베이스로 이동

  2. 삭제하려는 데이터베이스의 작업 열에서 더보기를 클릭합니다. 삭제를 클릭합니다. 대화상자가 나타납니다.

  3. 데이터베이스를 삭제하시겠어요? 대화상자의 텍스트 필드에 데이터베이스 ID를 입력하여 삭제를 확인합니다. 삭제를 클릭합니다. 콘솔에 작업의 성공 또는 실패가 표시됩니다.

    작업이 실패하면 데이터베이스 세부정보를 보고 삭제 보호가 사용 중지되어 있는지 확인합니다. 삭제 보호를 중지하려면 삭제 보호 설정 업데이트를 참조하세요.

다음 단계