쿼리 저장 및 공유

이 페이지에서는 쿼리를 저장하고 공유하는 방법을 설명합니다. 저장 또는 공유된 쿼리에는 쿼리 자체만 포함됩니다.

  • 공유된 쿼리는 쿼리 텍스트만 제공합니다. 데이터를 쿼리하려면 적합한 액세스 권한이 필요합니다. 쿼리 텍스트만 저장하는 경우 한 가지 이점은 유효한 쿼리가 아니더라도 불완전한 쿼리를 공유하고 이를 다른 사용자가 완성하거나 맞춤설정할 수 있는 템플릿으로 사용할 수 있다는 점입니다.

  • 저장된 쿼리에 유지되는 유일한 쿼리 옵션은 쿼리가 이전 SQL 또는 표준 SQL을 사용하는지 여부를 제어하는 'SQL 버전'입니다.

저장된 쿼리의 유형은 3가지입니다.

  • 비공개: 쿼리를 만드는 사용자만 비공개 저장된 쿼리를 볼 수 있습니다.
  • 프로젝트 수준: 필요한 권한을 가진 사전 정의된 BigQuery IAM 역할의 구성원이 프로젝트 수준에 저장된 쿼리를 볼 수 있습니다.
  • 공개: 쿼리 링크가 있는 모든 사용자가 공개 저장된 쿼리를 볼 수 있습니다.

권한

저장된 쿼리에서 만들기, 보기, 업데이트, 삭제를 수행하려면 다음 IAM 권한이 필요합니다.

  • 비공개 저장된 쿼리:
    • 비공개 저장된 쿼리를 만드는 경우에는 특별한 권한이 필요 없습니다. 모든 프로젝트에 비공개 쿼리를 저장할 수 있지만 만든 사용자만 쿼리를 보거나 업데이트하거나 삭제할 수 있습니다.
  • 프로젝트 수준 저장된 쿼리:
    • 프로젝트 수준에 저장된 쿼리를 만들려면 bigquery.savedqueries.create 권한이 필요합니다. bigquery.admin 사전 정의된 프로젝트 수준 IAM 역할에는 bigquery.savedqueries.create 권한이 포함됩니다.
    • 프로젝트 수준에 저장된 쿼리를 보려면 bigquery.savedqueries.getbigquery.savedqueries.list 권한이 필요합니다. bigquery.adminbigquery.user 사전 정의된 프로젝트 수준 IAM 역할에는 bigquery.savedqueries.getbigquery.savedqueries.list 권한이 포함됩니다.
    • 프로젝트 수준에 저장된 쿼리를 업데이트하려면 bigquery.savedqueries.update 권한이 필요합니다. bigquery.admin 사전 정의된 프로젝트 수준 IAM 역할에는 bigquery.savedqueries.update 권한이 포함됩니다.
    • 프로젝트 수준에 저장된 쿼리를 삭제하려면 bigquery.savedqueries.delete 권한이 필요합니다. bigquery.admin 사전 정의된 프로젝트 수준 IAM 역할에는 bigquery.savedqueries.delete 권한이 포함됩니다.
  • 공개 저장된 쿼리:
    • 공개 쿼리를 만드는 경우 특별한 권한이 필요 없습니다. 모든 프로젝트에 공개 쿼리를 저장할 수 있지만 만든 사용자만 쿼리를 업데이트하거나 삭제할 수 있습니다. 링크가 있는 모든 사용자가 공개 저장된 쿼리를 볼 수 있습니다.

BigQuery의 IAM 역할에 대한 자세한 내용은 액세스 제어를 참조하세요.

비공개 저장된 쿼리 만들기

쿼리를 저장하고 공개 상태를 비공개로 설정하면 만든 사용자만 쿼리를 보거나, 업데이트하거나, 삭제할 수 있습니다.

비공개 공유 쿼리를 만드는 방법은 다음과 같습니다.

콘솔

  1. GCP Console에서 BigQuery 웹 UI를 엽니다.
    BigQuery 웹 UI로 이동

  2. 새 쿼리 작성을 클릭합니다.

  3. 쿼리 편집기 텍스트 영역에 유효한 BigQuery SQL 쿼리를 입력합니다. 예를 들어 웹 UI 빠른 시작에 있는 쿼리를 사용할 수 있습니다.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. 쿼리 저장을 클릭합니다.

  5. 쿼리 저장 대화상자에 쿼리 이름을 입력하고 공개 상태개인(본인만 수정 가능)으로 설정한 다음 저장을 클릭합니다.

    쿼리를 비공개로 저장

  6. 저장된 쿼리를 보려면 저장된 쿼리를 클릭합니다. 개인 쿼리 페이지는 기본적으로 열려 있어야 합니다.

  7. 저장된 쿼리 이름을 클릭하여 확장합니다.

  8. 쿼리 URL 공유를 클릭하여 공유 가능한 링크에 액세스하고 해당 링크를 클립보드에 복사합니다. 또는 쿼리 편집기 텍스트 영역 위의 링크 공유 버튼 아이콘을 통해 링크에 액세스할 수 있습니다.

  9. 팀의 다른 구성원과 링크를 공유합니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.
    BigQuery 웹 UI로 이동

  2. 쿼리 작성을 클릭합니다.

  3. 새 쿼리 텍스트 영역에 SQL 쿼리를 입력합니다. 예를 들어 기본 웹 UI 빠른 시작의 쿼리를 사용할 수 있습니다.

    #standardSQL
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. 쿼리 저장을 클릭하여 쿼리 저장 대화 상자를 엽니다.

  5. 쿼리 저장 대화 상자에 저장할 쿼리의 이름을 입력하고 공개 상태비공개(사용자에게만 표시)로 유지한 후 확인을 클릭합니다.

    쿼리 저장 대화상자

  6. 저장된 쿼리를 보려면 왼쪽 탐색 메뉴에서 쿼리 기록이 선택되었는지 확인하고 쿼리 섹션에서 저장된 쿼리를 클릭합니다.

    저장된 쿼리 목록

저장된 쿼리 공유

쿼리를 공유하려면 쿼리 저장 시 공개 상태를 프로젝트 또는 공개로 설정합니다. 프로젝트 공개 상태를 사용하면 필요한 권한을 가진 사전 정의된 BigQuery IAM 역할의 구성원이 쿼리를 보거나, 업데이트하거나, 삭제할 수 있습니다.

공개 상태가 공개인 경우, 쿼리 링크가 있는 모든 사용자가 쿼리를 볼 수 있지만 업데이트하거나 삭제하지는 못합니다. 쿼리를 실행하려면 사용자에게 쿼리에서 액세스하는 데이터에 대한 액세스 권한이 있어야 합니다. 자세한 내용은 데이터세트에 대한 액세스 제어를 참조하세요.

쿼리를 공유하는 경우, 다음 예와 같이 쿼리를 설명하는 주석을 포함하는 것이 좋습니다.

프로젝트 수준 저장된 쿼리 만들기

프로젝트의 다른 구성원과 쿼리를 공유하려면 다음 안내를 따르세요.

콘솔

  1. GCP Console에서 BigQuery 웹 UI를 엽니다.
    BigQuery 웹 UI로 이동

  2. 새 쿼리 작성을 클릭합니다.

  3. 쿼리 편집기 텍스트 영역에 유효한 BigQuery SQL 쿼리를 입력합니다. 예를 들어 웹 UI 빠른 시작에 있는 쿼리를 사용할 수 있습니다.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. 쿼리 저장을 클릭합니다.

  5. 쿼리 저장 대화상자에 쿼리 이름을 입력하고 공개 상태프로젝트(프로젝트 구성원만 수정 가능)으로 설정한 다음 저장을 클릭합니다.

    쿼리 프로젝트 저장

  6. 저장된 쿼리를 보려면 왼쪽 탐색창에서 저장된 쿼리를 클릭하고 프로젝트 쿼리를 클릭합니다.

    프로젝트 쿼리 탭

  7. 저장된 쿼리 이름을 클릭하여 확장합니다.

  8. 쿼리 URL 공유를 클릭하여 공유 가능한 링크에 액세스하고 해당 링크를 클립보드에 복사합니다. 또는 쿼리 편집기 텍스트 영역 위의 링크 공유 버튼 아이콘을 통해 링크에 액세스할 수 있습니다.

  9. 팀의 다른 구성원과 링크를 공유합니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.
    BigQuery 웹 UI로 이동

  2. 쿼리 작성을 클릭합니다.

  3. 새 쿼리 텍스트 영역에 SQL 쿼리를 입력합니다. 예를 들어 기본 웹 UI 빠른 시작의 쿼리를 사용할 수 있습니다.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. 쿼리 저장을 클릭하여 쿼리 저장 대화 상자를 엽니다.

  5. 쿼리 저장 대화 상자에서 저장할 쿼리의 이름을 입력하고 공개 상태프로젝트(프로젝트 구성원이 보고 편집할 수 있음)로 설정한 후 확인을 클릭합니다.

    쿼리 프로젝트 공유

  6. 저장된 쿼리를 보려면 왼쪽 탐색 메뉴에서 쿼리 기록이 선택되었는지 확인하고 쿼리 섹션에서 프로젝트 쿼리를 클릭합니다.

    프로젝트 쿼리 목록

  7. 저장된 쿼리 이름을 클릭하여 확장합니다.

    확장된 프로젝트 쿼리

  8. 링크 공유를 클릭하여 공유할 수 있는 링크에 액세스하고 링크를 클립보드에 복사합니다.

    프로젝트 쿼리 공유 링크

    또는 새 쿼리 텍스트 영역 위의 링크 아이콘을 통해 링크에 액세스할 수 있습니다.

    쿼리 링크 아이콘

  9. 팀의 다른 구성원과 링크를 공유합니다.

공개 저장된 쿼리 만들기

모든 사람과 쿼리를 공유하려면 다음 안내를 따르세요.

콘솔

현재 GCP Console을 사용하여 공개 저장된 쿼리를 만들 수 없습니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.
    BigQuery 웹 UI로 이동

  2. 쿼리 작성을 클릭합니다.

  3. 새 쿼리 텍스트 영역에 SQL 쿼리를 입력합니다. 예를 들어 기본 웹 UI 빠른 시작의 쿼리를 사용할 수 있습니다.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10;
  4. 쿼리 저장을 클릭하여 쿼리 저장 대화 상자를 엽니다.

  5. 쿼리 저장 대화 상자에서 저장할 쿼리의 이름을 입력하고 공개 상태공개(링크가 있는 모든 사람이 볼 수 있지만 편집할 수 없음)로 설정한 후 확인을 클릭합니다.

    쿼리 공개 공유

  6. 저장된 쿼리를 보려면 왼쪽 탐색 메뉴에서 쿼리 기록이 선택되었는지 확인하고 쿼리 섹션에서 저장된 쿼리를 클릭합니다.

    저장된 공개 쿼리 목록

  7. 저장된 공개 쿼리 이름을 클릭하여 확장합니다.

    확장된 공개 쿼리

  8. 링크 공유를 클릭하여 공유할 수 있는 링크에 액세스하고 링크를 클립보드에 복사합니다.

    공개 쿼리 공유 링크

    또는 새 쿼리 텍스트 영역 위의 링크 아이콘을 통해 링크에 액세스할 수 있습니다.

    공개 쿼리 링크 아이콘

  9. 링크를 공유합니다.

저장된 쿼리 업데이트

저장된 쿼리를 업데이트하려면 다음 안내를 따르세요.

콘솔

  1. GCP Console에서 BigQuery 웹 UI를 엽니다.
    BigQuery 웹 UI로 이동

  2. 왼쪽 탐색창에서 저장된 쿼리를 클릭하고 개인 쿼리(비공개 쿼리를 수정하려는 경우) 또는 프로젝트 쿼리(프로젝트 수준의 쿼리를 수정하려는 경우)를 클릭합니다. 쿼리를 클릭하여 확장합니다.

  3. 쿼리 오른쪽에 있는 편집기에서 쿼리 열기를 클릭합니다.

    쿼리 업데이트

  4. 쿼리를 수정합니다.

  5. 쿼리 저장을 클릭하여 이름을 변경하지 않고 쿼리를 업데이트합니다. 이름을 변경하려면 쿼리 저장 옆에 있는 아래쪽 화살표를 클릭하고 다른 이름으로 저장을 선택하여 표시되는 대화상자에서 필요한 부분을 업데이트합니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.
    BigQuery 웹 UI로 이동

  2. 왼쪽 탐색 메뉴에서 쿼리 기록을 클릭하고 쿼리 섹션에서 저장된 쿼리(비공개 쿼리 편집) 또는 프로젝트 쿼리(프로젝트 수준 또는 공개 쿼리 편집)를 클릭합니다.

    프로젝트 쿼리 목록

  3. 쿼리 오른쪽에서 쿼리 수정을 클릭합니다.

    쿼리 수정 버튼

  4. 쿼리를 수정합니다.

  5. 쿼리 저장을 클릭하여 쿼리 저장 대화 상자를 엽니다.

  6. 쿼리 저장 대화 상자에서 이름을 변경하지 않고 확인을 클릭합니다.

저장된 쿼리 삭제

저장된 쿼리를 삭제하려면 다음 안내를 따르세요.

콘솔

  1. GCP Console에서 BigQuery 웹 UI를 엽니다.
    BigQuery 웹 UI로 이동

  2. 왼쪽 탐색창에서 저장된 쿼리를 클릭하고 개인 쿼리(비공개 쿼리를 삭제하려는 경우) 또는 프로젝트 쿼리(프로젝트 수준의 쿼리를 삭제하려는 경우)를 클릭합니다. 쿼리를 클릭하여 확장합니다.

  3. 쿼리 오른쪽에 있는 삭제를 클릭합니다.

    쿼리 삭제

  4. 메시지가 나타나면 삭제를 클릭하여 확인합니다.

기본 UI

  1. BigQuery 웹 UI로 이동합니다.
    BigQuery 웹 UI로 이동

  2. 왼쪽 탐색 메뉴에서 쿼리 기록을 클릭합니다.

  3. 쿼리 오른쪽에서 저장된 쿼리 삭제 버튼(X)을 클릭합니다.

  4. 메시지가 나타나면 확인을 클릭합니다.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.