이 페이지에서는 세분화된 액세스 제어가 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 뷰
다음 뷰에는 큐의 데이터베이스 역할과 권한 정보가 표시됩니다.
- GoogleSQL 언어 데이터베이스:
INFORMATION_SCHEMA.TABLE_PRIVILEGES - PostgreSQL 언어 데이터베이스:
information_schema.table_privileges
Spanner는 큐를 테이블 수준 스키마 객체로 모델링하므로 큐에 부여된 권한은 TABLE_PRIVILEGES에 표시됩니다. 큐 테이블 반환 함수에 부여된 권한은 ROUTINE_PRIVILEGES에 표시됩니다.
이러한 뷰의 행은 현재 데이터베이스 역할의 권한을 기준으로 필터링됩니다. 이렇게 하면 주 구성원이 액세스 권한이 있는 역할, 권한, 큐만 볼 수 있습니다.
행 필터링은 다음 큐 메타데이터 뷰에도 적용됩니다.
GoogleSQL
INFORMATION_SCHEMA.TABLESINFORMATION_SCHEMA.COLUMNS
PostgreSQL
information_schema.tablesinformation_schema.columns
행 필터링은 큐 테이블 반환 함수(RECEIVE_QUEUE_NAME 및 RENEWLEASE_QUEUE_NAME)의 메타데이터 뷰에도 적용됩니다.
GoogleSQL
PostgreSQL
시스템 역할 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가 모두 필요한 변경 내역과 달리 큐 메시지 소비자는RECEIVETVF에 대한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문은 큐 임대 및 전송 상태 머신을 우회합니다. 이러한 권한은 관리 또는 유지보수 역할로 제한하는 것이 좋습니다.