폴더 만들기 및 관리

다음 문서에서는 BigQuery에서 폴더를 만들고 관리하는 방법을 설명합니다. 폴더를 사용하여 노트북, 저장된 쿼리, 데이터 캔버스, 데이터 준비 파일과 같은 단일 파일 코드 애셋을 정리하고 액세스를 제어할 수 있습니다. BigQuery는 개인이 자체 코드 애셋을 관리할 수 있는 사용자 폴더와 팀의 코드 애셋을 관리할 수 있는 팀 폴더를 제공합니다.

BigQuery 폴더는 Dataform으로 구동됩니다.

폴더를 만들기 전에 폴더로 코드 애셋 정리를 읽고 BigQuery 폴더가 어떻게 작동하는지 알아보세요.

시작하기 전에

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery and Dataform APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the BigQuery and Dataform APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    8.

    필요한 역할

    이 문서의 작업을 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트, 폴더 또는 리소스에 대한 적절한 IAM 역할을 부여해 달라고 요청하세요.

    BigQuery 파일 브라우저를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 BigQuery 사용자 (roles/bigquery.user) 또는 BigQuery Studio 사용자(roles/bigquery.studioUser) 역할을 부여해 달라고 요청하세요.

    폴더에 부여된 권한은 해당 폴더 내에 포함된 모든 파일 및 폴더에 전파됩니다.

    파일과 파일이 포함된 폴더에는 다음이 적용됩니다.

    역할 승인 날짜 권한 및 사용 사례
    코드 소유자 (roles/dataform.codeOwner) 파일 또는 폴더 파일 및 폴더 시스템의 리소스에 대한 전체 제어 권한을 부여합니다. 이 역할을 가진 사용자는 리소스 삭제, IAM 정책 설정, 이동 등 모든 작업을 실행할 수 있습니다.
    코드 편집자 (roles/dataform.codeEditor) 파일 또는 폴더 콘텐츠를 수정하고 관리할 수 있습니다. 이 역할이 있는 사용자는 폴더에 콘텐츠를 추가하고, 파일을 수정하고, 파일 또는 폴더의 IAM 정책을 가져올 수 있습니다. 리소스를 이동할 때 대상 폴더에도 이 역할이 필요합니다.
    코드 주석 작성자 (roles/dataform.codeCommenter) 파일 또는 폴더 코드 애셋 또는 폴더에 댓글을 달 수 있습니다.
    코드 뷰어 (roles/dataform.codeViewer) 파일 또는 폴더 읽기 전용 액세스 권한을 제공합니다. 이 역할이 있는 사용자는 파일 및 폴더의 콘텐츠를 쿼리할 수 있습니다.
    코드 생성자 (roles/dataform.codeCreator) 프로젝트 프로젝트 내에 새 파일과 폴더를 만들 수 있는 권한을 부여합니다.

    다음 역할은 팀 폴더 관리에만 적용됩니다.

    역할 승인 날짜 권한 및 사용 사례
    팀 폴더 소유자 (roles/dataform.teamFolderOwner) 팀 폴더 파일 및 폴더 시스템의 팀 폴더에 대한 전체 제어 권한을 부여합니다. 이 역할을 가진 사용자는 팀 폴더를 삭제하고 IAM 정책을 설정할 수 있습니다.
    팀 폴더 참여자 (roles/dataform.teamFolderContributor) 팀 폴더 팀 폴더 내에서 콘텐츠를 관리할 수 있습니다. 이 역할을 가진 사용자는 팀 폴더를 업데이트할 수 있습니다.
    팀 폴더 댓글 작성자 (roles/dataform.teamFolderCommenter) 팀 폴더 팀 폴더 및 포함된 코드 애셋에 댓글을 달 수 있습니다.
    팀 폴더 뷰어 (roles/dataform.teamFolderViewer) 팀 폴더 팀 폴더 및 콘텐츠에 대한 읽기 전용 액세스 권한을 제공합니다. 이 역할이 있는 사용자는 팀 폴더를 보고 IAM 정책을 가져올 수 있습니다.
    팀 폴더 생성자 (roles/dataform.teamFolderCreator) 프로젝트 프로젝트 내에 새 팀 폴더를 만들 수 있는 권한을 부여합니다.

    역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

    이러한 사전 정의된 역할에는 이 문서의 작업을 완료하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

    필수 권한

    • 폴더를 만듭니다.
      • 상위 사용자 폴더, 팀 폴더 또는 프로젝트에 대한 folders.create 권한
      • 상위 폴더 또는 팀 폴더에 대한 folders.addContents 권한
    • 폴더의 속성을 가져옵니다. 폴더에서 folders.get
    • 폴더 또는 팀 폴더의 콘텐츠 쿼리: 폴더에서 folders.queryContents
    • 폴더 업데이트: 폴더에 대한 folders.update 권한
    • 폴더 삭제: 폴더에서 folders.delete
    • 폴더의 IAM 정책 가져오기: 폴더의 folders.getIamPolicy
    • 폴더의 IAM 정책 설정: 폴더에 대한 folders.setIamPolicy
    • 폴더 이동하기:
      • 이동되는 폴더에 대한 folders.move 권한
      • 대상 폴더 또는 팀 폴더에 대한 folders.addContents (루트 폴더로 이동하는 경우에는 필요하지 않음)
    • 팀 폴더 만들기: 프로젝트에 대한 teamFolders.create 권한
    • 팀 폴더 삭제: 팀 폴더에서 teamFolders.delete
    • 팀 폴더의 IAM 정책 가져오기: 팀 폴더의 teamFolders.getIamPolicy
    • 팀 폴더에 대한 IAM 정책 설정: 팀 폴더에서 teamFolders.setIamPolicy
    • 팀 폴더의 속성을 가져옵니다. teamFolders.get 팀 폴더에서
    • 팀 폴더 업데이트: 팀 폴더의 teamFolders.update

    커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

    프로젝트의 모든 폴더와 파일에 대한 전체 액세스 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

    리소스 보기

    BigQuery에서 폴더와 코드 애셋을 보려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

      왼쪽 창이 표시되지 않으면 왼쪽 창 펼치기를 클릭하여 창을 엽니다.

    3. 선택한 프로젝트 및 코드 영역에서 폴더와 코드 애셋을 보려면 다음 중 하나를 실행하세요.

      • 사용자 (이메일 주소) 노드를 펼쳐 만든 폴더와 파일을 확인합니다.
      • 팀 폴더 노드를 펼쳐 액세스할 수 있는 모든 팀 폴더를 확인합니다.
      • 공유 문서함 노드를 펼쳐 다른 사용자가 나와 공유한 모든 폴더와 파일을 확인합니다.

    코드 리전 변경

    다른 코드 리전에 폴더와 코드 애셋이 있을 수 있습니다. 다음 단계에 따라 보고 있는 코드 리전을 변경하세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 프로젝트 이름 옆에 있는 파일 패널 작업 보기 > 코드 리전 전환을 클릭합니다.

    4. 확인하려는 코드 영역을 선택합니다.

    5. 저장을 클릭합니다.

    폴더 또는 코드 애셋 만들기

    이 절차를 사용하여 다음 리소스를 만드세요.

    • 모든 수준의 사용자 폴더 또는 코드 애셋
    • 팀 폴더의 하위 폴더
    • 팀 폴더의 하위 폴더에 있는 코드 애셋

    팀 폴더 만들기에 대한 자세한 내용은 팀 폴더 만들기를 참고하세요.

    BigQuery에서 폴더 또는 코드 애셋을 만들려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 사용자 루트 노드 또는 리소스를 만들 폴더를 선택합니다.

    4. 작업 보기 > 만들기를 클릭한 다음 만들 리소스의 유형을 선택합니다.

    5. 리소스 만들기 창에 새 리소스의 이름을 입력합니다.

    6. 저장을 클릭합니다.

    팀 폴더 만들기

    BigQuery에서 팀 폴더를 만들려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 팀 폴더 루트 노드를 선택합니다.

    4. 작업 보기 > 팀 폴더 만들기를 클릭합니다.

    5. 팀 폴더 만들기 대화상자에서 팀 폴더의 이름을 입력합니다.

    6. 만들기를 클릭합니다.

    코드 애셋 업로드

    BigQuery에서 코드 애셋을 업로드하려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 코드 애셋을 업로드할 폴더를 선택합니다.

    4. 작업 보기 > 업로드를 클릭한 다음 업로드할 코드 애셋 유형을 선택합니다.

    5. 리소스 업로드 창에서 다음 중 하나를 수행합니다.

      • 파일 업로드 라디오 버튼을 클릭한 다음 로컬 파일을 찾아 선택합니다.
      • URL 라디오 버튼을 클릭한 다음 GitHub 저장소에 있는 코드 애셋 파일의 URL을 입력합니다.

    6. 코드 애셋의 이름을 입력합니다.

    7. 선택사항: 코드 애셋을 저장할 리전을 선택합니다. 기본값과 다른 리전을 선택하면 선택한 리전이 앞으로 모든 새 코드 애셋이 생성되는 기본 리전이 됩니다.

    8. 저장을 클릭합니다.

    코드 애셋 다운로드

    BigQuery에서 코드 애셋을 다운로드하려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 다운로드할 코드 애셋을 선택합니다.

    4. 작업 보기 > 다운로드를 클릭합니다.

    폴더 또는 코드 애셋 이름 바꾸기

    BigQuery에서 폴더 또는 코드 애셋의 이름을 바꾸려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 이름을 바꿀 폴더 또는 코드 애셋을 선택합니다.

    4. 작업 보기 > 이름 바꾸기를 클릭합니다.

    5. 리소스 이름 바꾸기 대화상자에 리소스의 새 이름을 입력합니다.

    6. 이름 바꾸기를 클릭합니다.

    폴더 또는 코드 애셋 공유하기

    BigQuery에서 폴더 또는 코드 애셋을 공유하려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 공유하려는 폴더 또는 코드 애셋을 선택합니다.

    4. 공유 권한 창에서 사용자/그룹 추가를 클릭합니다.

    5. 새 주 구성원 필드에 주 구성원을 입력합니다.

    6. 다음 중 하나를 수행합니다.

    7. 저장을 클릭합니다.

    8. 노트북 정보 페이지로 돌아가려면 닫기를 클릭합니다.

    폴더 또는 코드 애셋 이동하기

    BigQuery에서 폴더 또는 코드 애셋을 이동하려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 이동할 폴더 또는 코드 애셋을 선택합니다.

    4. 작업 보기 > 이동을 클릭합니다.

    5. 리소스 이동 대화상자에서 리소스를 이동할 사용자 또는 팀 폴더를 선택합니다.

    6. 이동을 클릭합니다.

    폴더 또는 코드 애셋 복사하기

    BigQuery에서 폴더 또는 코드 애셋을 복사하려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 복사할 폴더 또는 코드 애셋을 선택합니다.

    4. 작업 보기 > 복사를 클릭합니다.

    5. 리소스 복사 대화상자에서 리소스를 복사할 사용자 또는 팀 폴더를 선택합니다.

    6. 복사를 클릭합니다.

    폴더 또는 코드 애셋 삭제

    BigQuery에서 폴더 또는 코드 애셋을 삭제하려면 다음 단계를 따르세요.

    1. BigQuery 페이지로 이동합니다.

      BigQuery로 이동

    2. 왼쪽 창에서 파일을 클릭하여 파일 브라우저를 엽니다.

      **파일** 을 클릭하여 파일 브라우저를 엽니다.

    3. 삭제할 폴더 또는 코드 애셋을 선택합니다.

    4. 작업 보기 > 삭제를 클릭합니다.

    5. 리소스 삭제 대화상자에서 삭제를 클릭합니다.

    다음 단계