조직 사용자¶

시작하기¶

조직 사용자를 1개 이상의 계정으로 가져오는 기본 워크플로는 다음과 같습니다.

1. 조직 계정의 글로벌 조직 관리자입니다.

   1. 여러 일반 계정에서 사용자가 될 각 사람에 대해 조직 사용자를 생성 합니다.

   2. 사용자를 논리적으로 그룹화하는 조직 사용자 그룹을 생성 합니다.

   3. 조직 사용자 그룹에 조직 사용자를 추가합니다.

   4. 일반 계정의 계정 관리자가 조직 사용자 그룹을 사용할 수 있도록 설정합니다.

2. 일반 계정의 관리자로 로그인합니다.

   1. 조직 사용자 그룹 을 계정으로 가져옵니다.

   2. 충돌을 확인하고 해결 합니다.

이 워크플로의 엔드투엔드 예시는 확장된 예 섹션을 참조하십시오.

조직 사용자 생성하기¶

조직 관리자는 로그인 이름, 이메일 등 사용자 오브젝트의 기본 속성을 가진 조직 사용자를 생성합니다. 이메일만 필수이지만, 사용자를 가져온 후에는 일반 계정에서 이러한 기본 속성을 설정할 수 없습니다. 이러한 기본 속성 목록은 CREATE ORGANIZATION USER 섹션을 참조하십시오.

예를 들어, 다음 명령은 조직 사용자를 생성합니다.

USE ROLE GLOBALORGADMIN;

CREATE ORGANIZATION USER asmith
   EMAIL = 'asmith@example.com'
   LOGIN_NAME = 'asmith@example.com';

조직 사용자 그룹¶

조직 사용자 그룹 은 조직 사용자의 논리적 그룹입니다. 조직 관리자는 이러한 조직 사용자 그룹을 생성한 다음 각 그룹에 속해야 하는 조직 사용자를 추가합니다. 계정 관리자가 조직 사용자 그룹을 계정으로 가져오면 해당 그룹의 모든 조직 사용자가 일반 계정의 사용자 오브젝트가 됩니다. 조직 사용자는 여러 조직 사용자 그룹의 멤버가 될 수 있습니다.

계정 관리자가 조직 사용자 그룹을 일반 계정으로 가져오면 Snowflake는 같은 이름의 액세스 제어 역할 을 생성합니다. 예를 들어, 조직 사용자 그룹의 이름이 data_stewards 인 경우 이 그룹을 일반 계정으로 가져오면 data_stewards 라는 역할이 생성됩니다. 조직 사용자 그룹에서 가져온 각 사용자에게는 이 역할이 부여됩니다.

일반 계정의 관리자는 조직 사용자 그룹에서 가져온 각 사용자에게 부여된 역할에 대한 권한을 부여하고 취소하여 액세스 제어를 세부적으로 조정할 수 있습니다. 새 역할에 계정별 역할을 부여하거나 계정별 역할에 새 역할을 부여할 수도 있습니다.

동일한 조직 사용자 그룹을 여러 일반 계정으로 가져와서 조직 전체에서 일관된 역할을 구현할 수 있습니다. 각 일반 계정은 역할에 계정별 권한을 할당할 수 있지만 이름 지정은 일관되게 유지됩니다. 또는 각 계정에 대해 별도의 조직 사용자 그룹을 생성한 다음 특정 계정에 필요한 조직 사용자를 해당 조직 사용자 그룹에 추가할 수 있습니다.

관리자가 동일한 조직 사용자를 포함하는 여러 조직 사용자 그룹을 가져오면 로컬 사용자는 한 명만 생성해지며 이 사용자에게는 모든 조직 사용자 그룹의 역할이 부여됩니다.

일반 계정의 계정 관리자를 위한 조직 사용자 그룹을 준비하는 조직 관리자 작업은 3단계로 진행됩니다.

1. 조직 사용자 그룹을 생성 합니다.

2. 그룹에 조직 사용자를 추가 합니다.

3. 그룹의 공개 여부를 설정 하여 이 그룹에 액세스할 수 있는 일반 계정을 지정합니다.

CREATE ORGANIZATION USER GROUP data_engineers_group;

ALTER ORGANIZATION USER GROUP data_engineers_group
   ADD ORGANIZATION USERS asmith, sjohnson;

ALTER ORGANIZATION USER GROUP data_engineers_group
   SET VISIBILITY = ACCOUNTS qa_env;

일반 계정에서 사용자 가져오기¶

조직 관리자가 조직 사용자 그룹을 생성한 후 일반 계정의 관리자는 ALTER ACCOUNT 명령을 실행하여 조직 사용자 그룹을 추가함으로써 조직 사용자를 가져올 수 있습니다. 이러한 관리자는 조직 관리자가 일반 계정이 액세스할 수 있도록 그룹의 표시 여부를 설정 한 경우에만 조직 사용자 그룹을 가져올 수 있습니다.

기본적으로 ACCOUNTADMIN 역할이 있는 사용자만 조직 사용자 그룹을 일반 계정으로 가져올 수 있습니다. 다른 사용자가 조직 그룹을 가져오도록 허용하려면 IMPORT ORGANIZATION USER GROUPS 권한을 부여하십시오.

조직 사용자 그룹을 일반 계정으로 가져오기 위한 구문은 다음과 같습니다.

ALTER ACCOUNT ADD ORGANIZATION USER GROUP <group_name>

조직 사용자 그룹을 가져와 사용자를 추가하는 예제는 확장된 예 을 참조하십시오.

사용자 가져오기 후 충돌 해결하기¶

일반 계정에서 조직 사용자를 가져오는 계정 관리자는 충돌이 있는지 수동으로 확인해야 합니다. 이러한 충돌은 사용자의 속성 또는 조직 사용자 그룹의 이름 사이에서 발생할 수 있습니다.

SELECT SYSTEM$LINK_ORGANIZATION_USER_GROUP('marketing_team');

SHOW ORGANIZATION USERS IN ORGANIZATION USER GROUP marketing_team;
SELECT * FROM TABLE(RESULT_SCAN(LAST_QUERY_ID())) WHERE "is_imported" = 'false';

SELECT SYSTEM$LINK_ORGANIZATION_USER('jloeb', 'jloebsmith');

USE ROLE ACCOUNTADMIN;
ALTER USER joe SET LOGIN_NAME = joe_login_renamed;

가져온 사용자 수정하기¶

일반 계정의 관리자는 ALTER USER 명령을 사용하여 사용자 오브젝트를 가져온 후 사용자 오브젝트의 속성의 하위 집합을 수정할 수 있습니다. 관리자는 조직 계정에서 조직 사용자에게 설정할 수 있는 속성을 제외한 모든 속성을 수정할 수 있습니다. 조직 계정에서만 설정할 수 있는 속성 목록은 CREATE ORGANIZATION USER 섹션을 참조하십시오.

조직 사용자 및 그룹 제거하기¶

조직 사용자 및 조직 사용자 그룹은 단일 계정에서 제거 하거나 조직 계정에 드래그 앤 드롭 하여 모든 계정에서 삭제할 수 있습니다.

ALTER ACCOUNT REMOVE ORGANIZATION USER GROUP data_stewards;

조직 사용자 및 조직 사용자 그룹 연결 해제하기¶

조직 사용자를 일반 계정으로 성공적으로 가져오면 로컬 사용자 오브젝트가 조직 사용자에 링크됩니다. 사용자 오브젝트를 계정에 유지하되 더 이상 조직 사용자와 연결하지 않으려면 SYSTEM$UNLINK_ORGANIZATION_USER 함수를 사용하여 로컬 사용자를 조직 사용자로부터 연결 해제할 수 있습니다. 사용자의 모든 속성이 보존되며 앞으로도 로컬 사용자로 관리할 수 있습니다.

마찬가지로 SYSTEM$UNLINK_ORGANIZATION_USER_GROUP 함수를 사용하여 조직 사용자 그룹을 추가하여 생성한 역할의 연결을 해제할 수 있습니다. 이렇게 하면 역할에 대한 모든 내용은 동일하게 유지되지만 조직 사용자 그룹에서 연결이 해제됩니다.

확장된 예¶

조직 관리자 워크플로

1. 조직 관리자가 되어 조직 계정에 로그인합니다.

2. 데이터 관리자인 두 사람에 대한 조직 사용자를 생성합니다.

   USE ROLE GLOBALORGADMIN;
   
   CREATE ORGANIZATION USER joe_kelley
   EMAIL = 'jkelley@example.com'
   LOGIN_NAME = 'jkelley@example.com';
   
   CREATE ORGANIZATION USER grace_vivian
   EMAIL = 'gvivian@example.com'
   LOGIN_NAME = 'gvivian@example.com';
   

   Copy

3. 데이터 관리자의 논리적 그룹을 나타내는 조직 사용자 그룹을 생성합니다.

   CREATE ORGANIZATION USER GROUP data_stewards_group;
   

   Copy

4. 조직 사용자를 새 조직 사용자 그룹에 추가합니다.

   ALTER ORGANIZATION USER GROUP data_stewards_group
      ADD ORGANIZATION USERS joe_kelley, grace_vivian;
   

   Copy

5. 모든 일반 계정이 조직 사용자 그룹을 가져올 수 있도록 허용합니다.

   ALTER ORGANIZATION USER GROUP data_stewards_group
      SET VISIBILITY = ALL;
   

   Copy

계정 관리자 워크플로

1. 계정 관리자가 되어 조직 사용자를 가져오려는 일반 계정에 로그인합니다.

2. 계정으로 가져올 수 있는 조직 사용자 그룹을 나열합니다.

   USE ROLE ACCOUNTADMIN;
   
   SHOW ORGANIZATION USER GROUPS;
   

   Copy

3. 조직 사용자 그룹을 계정으로 가져옵니다.

   ALTER ACCOUNT
     ADD ORGANIZATION USER GROUP data_stewards_group;
   

   Copy

4. 조직 사용자 그룹과 기존 역할 간의 충돌이 있는지 확인합니다.

   SHOW ORGANIZATION USER GROUPS;
   

   Copy

   is_imported 열의 값이 충돌이 없음을 나타내는 TRUE 인지 확인합니다.

5. 계정에 추가된 사용자를 목록으로 나열하고 충돌이 있는지 확인합니다.

   SHOW ORGANIZATION USERS IN ORGANIZATION USER GROUP data_stewards_group;
   

   Copy

   모든 조직 사용자에 대해 is_imported 열의 값이 TRUE 인지 확인하여 충돌이 없음을 나타냅니다.

관련 함수¶

조직 사용자 및 조직 사용자 그룹과 함께 작업하는 데 도움이 되는 함수 목록은 조직 사용자 및 조직 사용자 그룹 함수 섹션을 참조하십시오.