공동 작업에서 데이터 쿼리 - AWS Clean Rooms
SQL 코드 편집기 사용분석 빌더 사용차등 프라이버시가 적용된 데이터 쿼리최근 쿼리 보기쿼리 세부 정보 보기

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

공동 작업에서 데이터 쿼리

쿼리를 수행할 수 있는 구성원은 다음 중 한 가지를 수행할 수 있습니다.

  • SQL 코드 편집기를 사용하여 수동으로 SQL 쿼리를 작성합니다.

  • 분석 빌더 UI를 사용하면 SQL 코드를 작성할 필요 없이 쿼리를 작성할 수 있습니다.

  • 승인된 분석 템플릿을 사용하세요.

쿼리를 할 수 있는 구성원이 컬래버레이션의 테이블에 대해 SQL 쿼리를 실행하는 경우, AWS Clean Rooms 구성원을 대신하여 테이블에 액세스하는 관련 역할을 맡습니다. AWS Clean Rooms 필요에 따라 분석 규칙을 입력 쿼리와 해당 출력에 적용합니다.

AWS Clean Rooms 다른 쿼리 엔진과 다를 수 있는 SQL 쿼리를 지원합니다. 사양은 AWS Clean Rooms SQL 참조를 참조하세요. 차등 프라이버시로 보호되는 데이터 테이블에서 쿼리를 실행하려면 쿼리가 AWS Clean Rooms 차등 프라이버시의 범용 쿼리 구조와 호환되는지 확인해야 합니다.

참고

Clean Rooms에 암호화 컴퓨팅을 사용하는 경우 일부 SQL 작업에서는 올바른 결과가 생성되지 않습니다. 예를 들어, 암호화된 열에서 COUNT를 수행할 수 있지만 암호화된 번호에서 SUM을 수행하면 오류가 발생합니다. 또한 쿼리로 인해 잘못된 결과가 나올 수도 있습니다. 예를 들어 SUM이 열을 봉인하는 쿼리는 오류를 발생시킵니다. 하지만 봉인된 열에 대한 GROUP BY 쿼리는 성공한 것 같지만 일반 텍스트에 대한 GROUP BY 쿼리로 생성된 그룹과는 다른 그룹을 생성합니다.

다음 항목에서는 AWS Clean Rooms 콘솔을 사용하여 공동 작업에서 데이터를 쿼리하는 방법을 설명합니다.

AWS Clean Rooms StartProtectedQueryAPI 작업을 직접 호출하거나 AWS SDK를 사용하여 데이터를 쿼리하거나 쿼리를 보는 방법에 대한 자세한 내용은 AWS Clean Rooms API 참조를 참조하십시오.

쿼리 로깅에 대한 자세한 내용은 쿼리 로그인 AWS Clean Rooms 섹션을 참조하세요.

참고

암호화된 데이터 테이블에서 쿼리를 실행하면 암호화된열의 결과가 암호화됩니다.

쿼리 결과에 대한 자세한 내용은 쿼리 결과 수신 섹션을 참조하세요.

SQL 코드 편집기 사용

쿼리를 할 수 있는 구성원은 SQL 코드 편집기에서 SQL 코드를 작성하여 수동으로 쿼리를 작성할 수 있습니다. SQL 코드 편집기는 AWS Clean Rooms 콘솔의 쿼리 탭에 있는 분석 섹션에 있습니다.

SQL 코드 편집기가 기본적으로 표시됩니다. 분석 빌더를 사용하여 쿼리를 작성하려면 분석 빌더 사용을 참조하세요.

중요

코드 편집기에서 SQL 쿼리 작성을 시작한 다음 분석 빌더 UI를 켜면 쿼리가 저장되지 않습니다.

AWS Clean Rooms 다양한 SQL 명령, 함수 및 조건을 지원합니다. 자세한 내용은 AWS Clean Rooms SQL 참조의 섹션을 참조하세요.

작은 정보

쿼리 실행 도중 예정된 유지 관리가 실행되면 쿼리는 종료 후 롤백됩니다. 쿼리를 다시 시작해야 합니다.

SQL 코드 편집기를 사용하여 쿼리를 수동으로 작성하려면

  1. 사용자 AWS 계정 (아직 로그인하지 않은 경우) 를 사용하여 AWS Clean Rooms 콘솔에 AWS Management Console 로그인하고 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 공동 작업을 선택합니다.

  3. 구성원 권한 상태가 쿼리인 공동 작업을 선택합니다.

  4. 쿼리 탭에서 분석 섹션으로 이동합니다.

    참고

    분석 섹션은 결과를 받을 수 있는 구성원과 쿼리 컴퓨팅 비용을 지불해야 하는 구성원이 활성 구성원으로 공동 작업에 참여한 경우에만 표시됩니다.

  5. 쿼리 탭의 테이블에서 테이블 목록 및 관련 분석 규칙 유형(집계 분석 규칙, 목록 분석 규칙 또는 사용자 지정 분석 규칙)을 볼 수 있습니다.

    참고

    목록에 예상한 테이블이 보이지 않는 경우 다음과 같은 이유가 있을 수 있습니다.

  6. (선택 사항) 테이블의 스키마와 분석 규칙 컨트롤을 보려면 더하기 기호 아이콘(+)을 선택하여 테이블을 확장합니다.

  7. SQL 코드 편집기에 쿼리를 입력하여 쿼리를 작성합니다.

    (선택 사항) 예제 쿼리를 사용하려는 경우 (선택 사항) 열 이름 또는 함수를 삽입하려면 다음을 수행합니다

    1. 테이블 옆의 세로로 된 세 점을 선택합니다.

    2. 편집기에 삽입에서 예제 쿼리를 선택합니다.

      참고

      예제 쿼리를 삽입하면 편집기에 이미 있는 쿼리가 추가됩니다.

      쿼리 예제가 나타납니다. 테이블 아래에 나열된 모든 테이블이 쿼리에 포함됩니다.

    3. 쿼리에서 자리 표시자 값을 편집합니다.

    1. 열 옆에 있는 세 개의 수직 점을 선택합니다.

    2. 편집기에 삽입에서 열 이름을 선택합니다.

    3. 열에 허용된 함수를 수동으로 삽입하려면 열 옆에 있는 세 개의 세로 점을 선택하고 편집기에 삽입을 선택한 다음 허용된 함수의 이름(예: INNER JOIN, SUM, SUM DISTINCT, 또는 COUNT)을 선택합니다.

    4. Ctrl + Space를 눌러 코드 편집기에서 테이블 스키마를 볼 수 있습니다.

      참고

      쿼리가 가능한 구성원은 구성된 각 테이블 연결의 파티션 열을 보고 사용할 수 있습니다. 구성된 AWS Glue 테이블의 기반이 되는 테이블에서 파티션 열이 파티션 열로 레이블되어 있는지 확인하십시오.

    5. 쿼리에서 자리 표시자 값을 편집합니다.

  8. Run(실행)을 선택합니다.

    참고

    결과를 받을 수 있는 구성원이 쿼리 결과 설정을 구성하지 않은 경우 쿼리를 실행할 수 없습니다.

  9. 계속해서 매개변수를 조정하고 쿼리를 다시 실행하거나 + 버튼을 선택하여 새 탭에서 새 쿼리를 시작합니다.

참고

AWS Clean Rooms 명확한 오류 메시지를 제공하는 것을 목표로 합니다. 오류 메시지에 문제 해결에 도움이 되는 세부 정보가 충분하지 않은 경우 계정 팀에 문의하세요. 오류 발생 경위에 대한 설명과 오류 메시지(식별자 포함)를 제공하세요. 자세한 정보는 문제 해결 AWS Clean Rooms을 참조하세요.

분석 빌더 사용

SQL 코드를 작성할 필요 없이 분석 빌더를 사용하여 쿼리를 작성할 수 있습니다. 분석 빌더를 사용하면 다음과 같은 기능을 갖춘 공동 작업을 위한 쿼리를 작성할 수 있습니다.

  • 집계 분석 규칙을 사용하는 단일 테이블(JOIN 필요 없음)

  • 집계 분석 규칙을 모두 사용하는 두 테이블(각 멤버에서 하나씩)

  • 목록 분석 규칙을 모두 사용하는 두 테이블(각 멤버에서 하나씩)

  • 집계 분석 규칙을 모두 사용하는 두 개의 테이블(각 구성원에서 하나씩)과 목록 분석 규칙을 모두 사용하는 두 개의 테이블(각 구성원에서 하나씩)

SQL 쿼리를 수동으로 작성하려면 SQL 코드 편집기 사용을 참조하세요.

분석 빌더는 AWS Clean Rooms 콘솔의 쿼리 탭에 있는 분석 섹션에 분석 빌더 UI 옵션으로 표시됩니다.

중요

분석 빌더 UI를 켜고 분석 빌더에서 쿼리 작성을 시작한 다음 분석 빌더 UI를 끄면 쿼리가 저장되지 않습니다.

작은 정보

쿼리 실행 도중 예정된 유지 관리가 실행되면 쿼리는 종료 후 롤백됩니다. 쿼리를 다시 시작해야 합니다.

다음 항목에서는 분석 체계를 사용하는 방법을 설명합니다.

분석 빌더를 사용하여 단일 테이블 (집계) 을 쿼리할 수 있습니다

이 절차는 AWS Clean Rooms 콘솔의 Analysis Builder UI를 사용하여 쿼리를 작성하는 방법을 보여줍니다. 이 쿼리는 별도 필요 없이 JOIN집계 분석 규칙을 사용하는 단일 테이블이 있는 공동 작업용입니다.

분석 빌더를 사용하여 단일 테이블을 쿼리하려면

  1. AWS 계정 (아직 로그인하지 않은 경우) 를 사용하여 AWS Clean Rooms 콘솔에 AWS Management Console 로그인하고 콘솔을 여십시오.

  2. 왼쪽 탐색 창에서 공동 작업을 선택합니다.

  3. 구성원 권한 상태가 쿼리인 공동 작업을 선택합니다.

  4. 쿼리 탭의 테이블에서 테이블 및 관련 분석 규칙 유형을 확인합니다. (분석 규칙 유형은 집계 분석 규칙이어야 합니다.)

    참고

    예상한 테이블이 보이지 않는 경우 다음과 같은 이유가 있을 수 있습니다.

  5. 분석 섹션에서 분석 빌더 UI를 켜세요.

  6. 쿼리를 작성하세요.

    모든 집계 지표를 보려면 9단계로 건너뛰세요.

    1. 지표 선택에서는 기본적으로 사전 선택된 집계 지표를 검토하고 필요한 경우 지표를 제거합니다.

    2. (선택 사항) 세그먼트 추가 — 선택 사항의 경우 하나 이상의 매개 변수를 선택합니다.

      참고

      세그먼트 추가 - 선택 사항은 테이블에 치수가 지정된 경우에만 표시됩니다.

    3. (선택 사항) 필터 추가 - 선택 사항의 경우 필터 추가를 선택한 다음 매개 변수, 연산자 및 값을 선택합니다.

      다른 필터 그룹을 추가하려는 경우, 필터 그룹 추가를 선택합니다.

      필터를 제거하려면 제거를 선택합니다.

      참고

      ORDER BY는 집계 쿼리에는 지원되지 않습니다.

      AND 연산자만 필터에서 지원됩니다.

    4. (선택 사항) 설명 추가 - 선택 사항에는 쿼리 목록에서 쿼리를 식별하는 데 도움이 되는 설명을 입력합니다.

  7. SQL 코드 미리 보기를 확장합니다.

    1. 분석 빌더에서 생성된 SQL 코드를 확인합니다.

    2. SQL 코드를 복사하려면 복사를 선택합니다.

    3. SQL 코드를 편집하려면 SQL 코드 편집기에서 편집을 선택합니다.

  8. Run(실행)을 선택합니다.

    참고

    결과를 받을 수 있는 구성원이 쿼리 결과 설정을 구성하지 않은 경우 쿼리를 실행할 수 없습니다.

  9. 계속해서 매개변수를 조정하고 쿼리를 다시 실행하거나 + 버튼을 선택하여 새 탭에서 새 쿼리를 시작합니다.

참고

AWS Clean Rooms 명확한 오류 메시지를 제공하는 것을 목표로 합니다. 오류 메시지에 문제 해결에 도움이 되는 세부 정보가 충분하지 않은 경우 계정 팀에 문의하세요. 오류 발생 경위에 대한 설명과 오류 메시지(식별자 포함)를 제공하세요. 자세한 정보는 문제 해결 AWS Clean Rooms을 참조하세요.

분석 빌더를 사용하여 두 테이블(집계 또는 목록)을 쿼리할 수 있습니다

이 절차에서는 AWS Clean Rooms 콘솔의 분석 빌더를 사용하여 다음과 같은 협업을 위한 쿼리를 작성하는 방법을 설명합니다.

  • 집계 분석 규칙을 모두 사용하는 두 테이블(각 구성원에서 하나씩)

  • 목록 분석 규칙을 모두 사용하는 두 테이블(각 멤버에서 하나씩)

  • 집계 분석 규칙을 모두 사용하는 두 개의 테이블(각 구성원에서 하나씩)과 목록 분석 규칙을 모두 사용하는 두 개의 테이블(각 구성원에서 하나씩)

분석 빌더를 사용하여 두 테이블을 쿼리하려면

  1. AWS 계정 (아직 로그인하지 않은 경우) 를 사용하여 AWS Clean Rooms 콘솔에 AWS Management Console 로그인하고 콘솔을 여십시오.

  2. 왼쪽 탐색 창에서 공동 작업을 선택합니다.

  3. 구성원 권한 상태가 쿼리인 공동 작업을 선택합니다.

  4. 쿼리 탭의 테이블에서 두 테이블과 관련 분석 규칙 유형(집계 분석 규칙 또는 목록 분석 규칙)을 확인합니다.

    참고

    목록에 예상한 테이블이 보이지 않는 경우 다음과 같은 이유가 있을 수 있습니다.

  5. 분석 섹션에서 분석 빌더 UI를 켜세요.

  6. 쿼리를 작성하세요.

    공동 작업에 집계 분석 규칙을 사용하는 두 개의 테이블과 목록 분석 규칙을 사용하는 두 개의 테이블이 포함된 경우 먼저 집계 또는 목록을 선택한 다음 선택한 분석 규칙을 기반으로 프롬프트를 따릅니다.

    두 테이블에서 집계 분석 규칙을 사용하는 경우 두 테이블이 목록 분석 규칙을 사용하는 경우

    1. 지표 선택에서는 기본적으로 미리 선택된 집계 지표를 검토하고 필요한 경우 지표를 제거합니다.

    2. 매치 레코드의 경우 하나 이상의 레코드를 선택합니다.

      참고

      분석 빌더를 사용하는 경우 한 쌍의 열에서만 매칭할 수 있습니다.

    3. (선택 사항) 세그먼트 추가 — 선택 사항의 경우 하나 이상의 매개 변수를 선택합니다.

      참고

      세그먼트 추가 - 선택 사항은 테이블에 치수가 지정된 경우에만 표시됩니다.

    4. (선택 사항) 필터 추가 - 선택 사항의 경우 필터 추가를 선택한 다음 매개 변수, 연산자 및 값을 선택합니다.

      다른 필터 그룹을 추가하려는 경우, 필터 그룹 추가를 선택합니다.

      필터를 제거하려면 제거를 선택합니다.

      참고

      ORDER BY는 집계 쿼리에는 지원되지 않습니다.

      AND 연산자만 필터에서 지원됩니다.

    5. (선택 사항) 설명 추가 - 선택 사항에는 최근 쿼리 목록에서 쿼리를 식별하는 데 도움이 되는 설명을 입력합니다.

    1. 속성 선택의 경우 기본적으로 미리 선택된 목록 속성을 검토하고 필요한 경우 지표를 제거합니다.

    2. 매치 레코드의 경우 하나 이상의 레코드를 선택합니다.

      참고

      분석 빌더를 사용하는 경우 한 쌍의 열에서만 매칭할 수 있습니다.

    3. (선택 사항) 필터 추가 - 선택 사항의 경우 필터 추가를 선택한 다음 매개 변수, 연산자 및 값을 선택합니다.

      다른 필터 그룹을 추가하려는 경우, 필터 그룹 추가를 선택합니다.

      필터를 제거하려면 제거를 선택합니다.

      참고

      목록 쿼리에는 LIMIT이 지원되지 않습니다.

      AND 연산자만 필터에서 지원됩니다.

    4. (선택 사항) 설명 추가 - 선택 사항에는 최근 쿼리 목록에서 쿼리를 식별하는 데 도움이 되는 설명을 입력합니다.

  7. SQL 코드 미리 보기를 확장합니다.

    1. 분석 빌더에서 생성된 SQL 코드를 확인합니다.

    2. SQL 코드를 복사하려면 복사를 선택합니다.

    3. SQL 코드를 편집하려면 SQL 코드 편집기에서 편집을 선택합니다.

  8. Run(실행)을 선택합니다.

    참고

    결과를 받을 수 있는 구성원이 쿼리 결과 설정을 구성하지 않은 경우 쿼리를 실행할 수 없습니다.

  9. 계속해서 매개변수를 조정하고 쿼리를 다시 실행하거나 + 버튼을 선택하여 새 탭에서 새 쿼리를 시작합니다.

참고

AWS Clean Rooms 명확한 오류 메시지를 제공하는 것을 목표로 합니다. 오류 메시지에 문제 해결에 도움이 되는 세부 정보가 충분하지 않은 경우 계정 팀에 문의하세요. 오류 발생 경위에 대한 설명과 오류 메시지(식별자 포함)를 제공하세요. 자세한 정보는 문제 해결 AWS Clean Rooms을 참조하세요.

차등 프라이버시가 적용된 데이터 쿼리

일반적으로 차등 프라이버시가 켜져 있어도 쿼리 작성 및 실행은 변경되지 않습니다. 하지만 남은 프라이버시 예산이 충분하지 않으면 쿼리를 실행할 수 없습니다. 쿼리를 실행하고 프라이버시 예산을 사용함에 따라 실행할 수 있는 집계 수와 향후 쿼리에 미치는 영향을 대략적으로 확인할 수 있습니다.

공동 작업에서 차등 프라이버시가 미치는 영향을 보려면

  1. 를 사용하여 AWS Clean Rooms 콘솔에 AWS Management Console 로그인하고 여십시오 AWS 계정 (아직 로그인하지 않은 경우).

  2. 왼쪽 탐색 창에서 공동 작업을 선택합니다.

  3. 구성원 세부 정보 상태가 쿼리 실행인 공동 작업을 선택합니다.

  4. 쿼리 탭의 테이블에서 남은 프라이버시 예산을 확인합니다. 남은 집계 함수의 예상 수와 사용된 유틸리티(백분율로 표시)로 표시됩니다.

    참고

    남은 집계 함수의 예상 수와 사용된 유틸리티의 백분율은 쿼리가 가능한 구성원에 대해서만 표시됩니다.

  5. 결과에 주입되는 노이즈의 양과 실행할 수 있는 집계 함수의 대략적인 수를 보려면 영향 보기를 선택합니다.

최근 쿼리 보기

최근 쿼리 탭에서 지난 90일 동안 실행된 쿼리를 볼 수 있습니다.

참고

멤버 권한은 데이터 기여뿐이고 쿼리 계산 비용을 지불하는 구성원이 아닌 경우 콘솔에 쿼리 탭이 표시되지 않습니다.

최근 쿼리 보려는 경우

  1. AWS 계정 (아직 로그인하지 않은 경우) 으로 AWS Clean Rooms 콘솔에 AWS Management Console 로그인하고 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 공동 작업을 선택합니다.

  3. 공동 작업을 선택합니다.

  4. 쿼리 탭의 쿼리에서 지난 90일 동안 실행된 쿼리를 확인합니다.

  5. 최근 쿼리를 상태별로 정렬하려면 모든 상태 드롭다운 목록에서 상태를 선택합니다.

    상태는 제출됨, 시작됨, 취소됨, 성공, 실패, 시간 초과입니다.

쿼리 세부 정보 보기

쿼리를 실행할 수 있는 구성원 또는 결과를 받을 수 있는 구성원으로 쿼리 세부 정보를 볼 수 있습니다.

쿼리 세부 정보를 보려면

  1. AWS 계정 (아직 로그인하지 않은 경우) 으로 AWS Clean Rooms 콘솔에 AWS Management Console 로그인하고 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 공동 작업을 선택합니다.

  3. 공동 작업을 선택합니다.

  4. 쿼리 탭에서 다음 중 한 가지를 수행합니다.

    • 보려는 특정 쿼리에 대한 옵션 버튼을 선택한 다음 세부정보 보기를 선택합니다.

    • 보호된 쿼리 ID를 선택합니다.

  5. 쿼리 세부정보 페이지에서,

    • 쿼리를 실행할 수 있는 구성원인 경우 쿼리 세부 정보, SQL 텍스트 및 결과를 확인하세요.

      결과를 받을 수 있는 구성원에게 쿼리 결과가 전달되었음을 확인하는 메시지가 표시됩니다.

    • 결과를 받을 수 있는 회원인 경우 쿼리 세부 정보 및 결과를 확인하세요.