대기열에 대해 세분화된 액세스 제어

이 페이지에서는 세분화된 액세스 제어가 GoogleSQL 언어 데이터베이스 및 PostgreSQL 언어 데이터베이스의 Spanner 큐에서 작동하는 방식을 설명합니다.

Spanner에서 큐는 스키마 객체로 정의됩니다. 메시지 전송, 메시지 수신, 메시지 임대 연장, 메시지 확인 및 삭제, 큐 쿼리에 대한 액세스는 표준 Spanner 데이터베이스 역할 및 권한을 직접 준수합니다.

메시지 전송 권한 부여(프로듀서)

DML(INSERT INTO) 또는 변형 API(Insert 문 참조)를 사용하여 큐에 메시지를 보내려면 큐에 대한 INSERT 권한을 데이터베이스 역할에 부여합니다.

GoogleSQL

GRANT INSERT ON QUEUE QUEUE_NAME TO ROLE ROLE_NAME;

PostgreSQL

GRANT INSERT ON QUEUE QUEUE_NAME TO ROLE_NAME;

권한을 취소하려면 다음 안내를 따르세요.

GoogleSQL

REVOKE INSERT ON QUEUE QUEUE_NAME FROM ROLE ROLE_NAME;

PostgreSQL

REVOKE INSERT ON QUEUE QUEUE_NAME FROM ROLE_NAME;

메시지 수신 권한 부여(소비자)

큐에서 메시지를 스트리밍하기 위해 소비자 작업자는 ExecuteStreamingSQL를 사용하여 RECEIVE_QUEUE_NAME() 테이블 값 함수(TVF)를 실행합니다.

데이터베이스 역할이 큐에서 메시지를 스트리밍하도록 허용하려면 자동으로 생성된 RECEIVE_QUEUE_NAME 함수에 대한 EXECUTE를 부여합니다.

GoogleSQL

GRANT EXECUTE ON TABLE FUNCTION RECEIVE_QUEUE_NAME TO ROLE ROLE_NAME;

PostgreSQL

GRANT EXECUTE ON FUNCTION spanner.receive_QUEUE_NAME TO ROLE_NAME;

권한을 취소하려면 다음 안내를 따르세요.

GoogleSQL

REVOKE EXECUTE ON TABLE FUNCTION RECEIVE_QUEUE_NAME FROM ROLE ROLE_NAME;

PostgreSQL

REVOKE EXECUTE ON FUNCTION spanner.receive_QUEUE_NAME FROM ROLE_NAME;

RECEIVE_QUEUE_NAME()를 호출하려면 TVF에 EXECUTE만 필요하며 큐에 SELECT는 필요하지 않습니다.

메시지 임대 연장

소비자가 메시지를 수신하면 Spanner는 초기 10초 임대를 할당합니다. 메시지 처리가 초기 임대보다 오래 걸리는 경우 소비자는 RENEWLEASE_QUEUE_NAME() TVF를 사용하여 임대를 연장해야 합니다.

임대를 연장하려면 역할에 RENEWLEASE_QUEUE_NAME 함수에 대한 EXECUTE가 있어야 합니다.

GoogleSQL

GRANT EXECUTE ON TABLE FUNCTION RENEWLEASE_QUEUE_NAME TO ROLE ROLE_NAME;

PostgreSQL

GRANT EXECUTE ON FUNCTION spanner.renewlease_QUEUE_NAME TO ROLE_NAME;

권한을 취소하려면 다음 안내를 따르세요.

GoogleSQL

REVOKE EXECUTE ON TABLE FUNCTION RENEWLEASE_QUEUE_NAME FROM ROLE ROLE_NAME;

PostgreSQL

REVOKE EXECUTE ON FUNCTION spanner.renewlease_QUEUE_NAME FROM ROLE_NAME;

RENEWLEASE_QUEUE_NAME()를 호출하려면 TVF에 대한 EXECUTE만 필요하며 큐에 대한 SELECT는 필요하지 않습니다.

PostgreSQL 언어 데이터베이스에서 spanner.은 스키마가 아닌 큐 TVF 이름의 필수 프리픽스입니다. 큐 TVF를 호출하거나 권한을 부여할 때는 항상 spanner. 프리픽스를 사용합니다(예: spanner.receive_QUEUE_NAME). 대신 public. 프리픽스를 사용할 수 없습니다. 일괄 권한 부여의 경우 큐 TVF는 public 스키마에 속하므로 public 스키마에 대한 일괄 권한 부여에 포함됩니다. GoogleSQL 언어 데이터베이스에서 기본 스키마의 모든 테이블 함수에 대한 일괄 권한 부여에는 큐 TVF가 포함됩니다. 자세한 내용은 주의사항 및 고려사항을 참조하세요.

메시지 수신 및 임대 연장에 대한 자세한 내용은 큐 사용을 참조하세요.

큐를 직접 쿼리할 수 있는 권한

표준 SQL(SELECT * FROM QUEUE_NAME) 또는 Read API를 사용하여 큐에서 직접 메시지를 읽거나 검사하려면 큐에 대한 SELECT 권한을 부여합니다.

GoogleSQL

GRANT SELECT ON QUEUE QUEUE_NAME TO ROLE ROLE_NAME;

PostgreSQL

GRANT SELECT ON QUEUE QUEUE_NAME TO ROLE_NAME;

권한을 취소하려면 다음 안내를 따르세요.

GoogleSQL

REVOKE SELECT ON QUEUE QUEUE_NAME FROM ROLE ROLE_NAME;

PostgreSQL

REVOKE SELECT ON QUEUE QUEUE_NAME FROM ROLE_NAME;

큐에 SELECT를 부여하면 큐를 테이블로 쿼리할 수 있지만 RECEIVE_QUEUE_NAME() 또는 RENEWLEASE_QUEUE_NAME()에 대한 EXECUTE는 부여되지 않습니다.

메시지 확인 및 삭제 권한

DML(DELETE FROM) 또는 변형 API(Ack 또는 Delete)를 사용하여 큐에서 메시지를 확인하거나 삭제하려면 큐에 대한 DELETE 권한을 부여합니다.

GoogleSQL

GRANT DELETE ON QUEUE QUEUE_NAME TO ROLE ROLE_NAME;

PostgreSQL

GRANT DELETE ON QUEUE QUEUE_NAME TO ROLE_NAME;

권한을 취소하려면 다음 안내를 따르세요.

GoogleSQL

REVOKE DELETE ON QUEUE QUEUE_NAME FROM ROLE ROLE_NAME;

PostgreSQL

REVOKE DELETE ON QUEUE QUEUE_NAME FROM ROLE_NAME;

큐 작업에 필요한 권한

다음 표에는 일반적인 큐 작업에 필요한 권한이 요약되어 있습니다.

작업 필수 권한
메시지 전송(DML INSERT 또는 Mutation API Send) 큐에 대한 INSERT 권한
메시지 수신(RECEIVE_QUEUE_NAME() TVF) RECEIVE_QUEUE_NAME 함수의 EXECUTE
메시지 임대 연장(RENEWLEASE_QUEUE_NAME() TVF) RENEWLEASE_QUEUE_NAME 함수의 EXECUTE
메시지 확인 또는 삭제(DML DELETE 또는 변형 API Ack 또는 Delete) 큐에 대한 DELETE 권한
큐 데이터 직접 읽기(SQL SELECT 또는 Read API) 큐에 대한 SELECT 권한

예시: 생산자 및 소비자 역할 구성

다음 예시에서는 OrdersQueue라는 큐에서 프로듀서, 소비자, 감사자에 대해 별도의 데이터베이스 역할을 구성합니다.

GoogleSQL

-- Create producer role and grant send permissions
CREATE ROLE queue_producer;
GRANT INSERT ON QUEUE OrdersQueue TO ROLE queue_producer;

-- Create consumer role and grant receive, renew, and delete permissions
CREATE ROLE queue_consumer;
GRANT EXECUTE ON TABLE FUNCTION RECEIVE_OrdersQueue TO ROLE queue_consumer;
GRANT EXECUTE ON TABLE FUNCTION RENEWLEASE_OrdersQueue TO ROLE queue_consumer;
GRANT DELETE ON QUEUE OrdersQueue TO ROLE queue_consumer;

-- Create reader role for inspection without consumer streaming permissions
CREATE ROLE queue_reader;
GRANT SELECT ON QUEUE OrdersQueue TO ROLE queue_reader;

PostgreSQL

-- Create producer role and grant send permissions
CREATE ROLE queue_producer;
GRANT INSERT ON QUEUE OrdersQueue TO queue_producer;

-- Create consumer role and grant receive, renew, and delete permissions
CREATE ROLE queue_consumer;
GRANT EXECUTE ON FUNCTION spanner.receive_OrdersQueue TO queue_consumer;
GRANT EXECUTE ON FUNCTION spanner.renewlease_OrdersQueue TO queue_consumer;
GRANT DELETE ON QUEUE OrdersQueue TO queue_consumer;

-- Create reader role for inspection without consumer streaming permissions
CREATE ROLE queue_reader;
GRANT SELECT ON QUEUE OrdersQueue TO queue_reader;

큐에 대한 INFORMATION_SCHEMA 뷰

다음 뷰에는 큐의 데이터베이스 역할과 권한 정보가 표시됩니다.

Spanner는 큐를 테이블 수준 스키마 객체로 모델링하므로 큐에 부여된 권한은 TABLE_PRIVILEGES에 표시됩니다. 큐 테이블 반환 함수에 부여된 권한은 ROUTINE_PRIVILEGES에 표시됩니다.

이러한 뷰의 행은 현재 데이터베이스 역할의 권한을 기준으로 필터링됩니다. 이렇게 하면 주 구성원이 액세스 권한이 있는 역할, 권한, 큐만 볼 수 있습니다.

행 필터링은 다음 큐 메타데이터 뷰에도 적용됩니다.

GoogleSQL

  • INFORMATION_SCHEMA.TABLES
  • INFORMATION_SCHEMA.COLUMNS

PostgreSQL

  • information_schema.tables
  • information_schema.columns

행 필터링은 큐 테이블 반환 함수(RECEIVE_QUEUE_NAME 및 RENEWLEASE_QUEUE_NAME)의 메타데이터 뷰에도 적용됩니다.

시스템 역할 spanner_info_reader 및 해당 구성원은 항상 필터링되지 않은 INFORMATION_SCHEMA를 확인합니다.

주의사항 및 고려사항

  • TVF 실행 및 직접 큐 쿼리에 대한 고유한 권한: 큐에 SELECT를 부여해도 연결된 테이블 값 함수(RECEIVE_QUEUE_NAME 또는 RENEWLEASE_QUEUE_NAME)에 대한 EXECUTE는 부여되지 않습니다. 마찬가지로 TVF에 EXECUTE를 부여해도 큐에 대한 SELECT는 부여되지 않습니다.

    • 큐에 SELECT만 있는 역할이 RECEIVE_QUEUE_NAME()를 실행하려고 하면 Spanner는 역할에 테이블 함수 RECEIVE_QUEUE_NAME에 필요한 권한이 없다는 오류를 반환합니다.
    • TVF에 EXECUTE만 있는 역할이 SELECT * FROM QUEUE_NAME를 실행하려고 하면 Spanner는 역할에 큐 QUEUE_NAME에 필요한 권한이 없다는 오류를 반환합니다.
  • 변경 내역과의 차이점: 스트림에 대한 SELECT와 읽기 함수에 대한 EXECUTE가 모두 필요한 변경 내역과 달리 큐 메시지 소비자는 RECEIVE TVF에 대한 EXECUTE만 필요합니다. 큐 자체에 대한 SELECT는 필요하지 않습니다.

  • PostgreSQL spanner. 프리픽스 및 일괄 권한 부여: PostgreSQL 언어 데이터베이스에서 spanner.receive_QUEUE_NAME 및 spanner.renewlease_QUEUE_NAME의 spanner.는 스키마가 아닌 함수 이름의 필수 프리픽스입니다. 큐 TVF를 호출하거나 권한을 부여할 때 이 프리픽스를 사용해야 합니다. public. 프리픽스는 작동하지 않습니다. 권한의 경우 이러한 함수는 public 스키마에 속합니다. 결과는 다음과 같습니다.

    • ALL FUNCTIONS IN SCHEMA public 또는 ALL ROUTINES IN SCHEMA public의 GRANT 및 REVOKE 문은 변경 내역 읽기 함수와 같은 다른 테이블 값 함수와 함께 모든 기존 큐 TVF에 적용됩니다. 다른 일괄 권한 부여와 마찬가지로 이러한 문은 나중에 만드는 큐에는 적용되지 않습니다.
    • spanner가 스키마가 아니므로 ALL FUNCTIONS IN SCHEMA spanner의 GRANT 및 REVOKE 문이 Schema `spanner` not found 오류로 인해 실패합니다.

    역할을 특정 큐로 제한하려면 public 스키마의 모든 함수에 부여하는 대신 각 큐 TVF에 개별적으로 EXECUTE를 부여합니다.

  • 큐 TVF에 대한 GoogleSQL 일괄 권한 부여: GoogleSQL 언어 데이터베이스에서 큐와 해당 TVF는 항상 기본 스키마에 속합니다. 이름이 지정된 스키마에서는 큐를 만들 수 없기 때문입니다. 자세한 내용은 제한사항을 참조하세요. 결과는 다음과 같습니다.

    • ALL TABLE FUNCTIONS IN SCHEMA DEFAULT의 GRANT 및 REVOKE 문은 변경 내역 읽기 함수와 같은 다른 테이블 값 함수와 함께 모든 기존 큐 TVF에 적용됩니다. 다른 일괄 권한 부여와 마찬가지로 이러한 문은 나중에 만드는 큐에는 적용되지 않습니다.
    • GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA DEFAULT는 사용자 정의 함수에만 적용되며 큐 TVF는 포함하지 않습니다.

    역할을 특정 큐로 제한하려면 기본 스키마의 모든 테이블 함수에 부여하는 대신 각 큐 TVF에 개별적으로 EXECUTE를 부여합니다.

  • GoogleSQL의 대소문자 구분 큐 TVF 이름: GoogleSQL 언어 데이터베이스는 대소문자를 구분하지 않고 쿼리의 식별자를 확인하지만 GRANT 및 REVOKE 문의 큐 TVF 이름은 대소문자를 구분합니다. 대문자 RECEIVE_ 또는 RENEWLEASE_ 프리픽스를 사용하고 그 뒤에 CREATE QUEUE 문에 작성한 것과 정확히 동일한 큐 이름을 사용합니다. 예를 들어 OrdersQueue라는 큐의 경우 RECEIVE_OrdersQueue 및 RENEWLEASE_OrdersQueue를 사용합니다. 프리픽스와 큐 이름이 모두 일치해야 합니다. receive_OrdersQueue 또는 RECEIVE_ordersqueue과 같이 두 부분 중 하나가 대소문자가 다른 경우 문이 TABLE_FUNCTION not found 오류와 함께 실패합니다.

  • 열 수준 권한은 지원되지 않음: 테이블과 달리 Spanner는 큐(예: GRANT SELECT (COLUMN_NAME) ON QUEUE)에 대한 열 수준 권한을 지원하지 않습니다. 큐에는 내부 시스템 메타데이터 열이 포함되므로 큐 객체 전체에 권한을 부여해야 합니다.

  • 생산자 및 소비자 역할 분리: 메시지 생산자와 메시지 소비자에 대해 별도의 데이터베이스 역할을 정의하는 것이 좋습니다. 예를 들면 다음과 같습니다.

    • 큐에 INSERT만 있는 생산자 역할
    • RECEIVE_QUEUE_NAME 및 RENEWLEASE_QUEUE_NAME 함수에 대한 EXECUTE가 있는 소비자 역할과 DELETE 또는 Ack 변형으로 메시지를 확인하는 경우 큐에 대한 DELETE가 있는 소비자 역할
  • 직접 DML과 큐 TVF 전송 비교: 직접 DELETE 또는 UPDATE 문은 큐 임대 및 전송 상태 머신을 우회합니다. 이러한 권한은 관리 또는 유지보수 역할로 제한하는 것이 좋습니다.

다음 단계