Snowflake Connector for ServiceNow® 관리, 업데이트 및 제거하기

ServiceNow®용 Snowflake 커넥터에는 커넥터 약관 이 적용됩니다.

이 항목과 이 항목의 섹션에서는 커넥터를 설치 및 구성한 후 수행해야 할 수도 있는 일반적인 작업을 설명합니다.

커넥터에서 사용하는 새로 고침 토큰 업데이트하기

OAuth 인증으로 커넥터를 설정하는 경우 새로 고침 토큰을 정기적으로 업데이트해야 합니다. 그렇지 않으면 토큰이 만료된 후 커넥터가 더 이상 ServiceNow에 액세스할 수 없습니다. 기본적으로 토큰은 생성 후 90일이 지나면 만료됩니다.

커넥터에 대한 이메일 알림 을 구성하면 매월 1일에 새로 고침 토큰을 업데이트하라는 미리 알림을 받게 됩니다. 토큰이 만료되는 경우 커넥터에 ServiceNow 액세스 문제가 발생하면 이메일을 받게 됩니다.

Snowsight를 사용하여 설치된 커넥터의 새로 고침 토큰 업데이트하기

커넥터가 Snowsight를 사용하여 설치된 경우 새로 고침 토큰을 업데이트하려면 다음을 수행하십시오.

  1. ACCOUNTADMIN 역할을 가진 사용자로 Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 Data Products » Marketplace 를 선택합니다.

  3. Snowflake Connector for ServiceNow® 를 검색한 다음 커넥터에 알맞은 타일을 선택합니다.

  4. Connections 에서 줄임표 버튼을 선택한 다음 Refresh token 을 선택합니다.

    참고

    커넥터를 처음 구성했을 때와 동일한 사용자로 ServiceNow에 로그인했는지 확인하십시오. 대화 상자의 오른쪽 위 모서리에서 현재 로그인한 사용자를 확인할 수 있습니다.

  5. 커넥터가 ServiceNow 계정에 연결할 수 있는지 확인하려면 대화 상자에서 Allow 를 선택하십시오.

    이제 새로 고침 토큰이 업데이트되었습니다.

SQL 명령을 사용하여 새로 고침 토큰을 업데이트하는 방법을 알아보려면 SQL 명령을 사용하여 새로 고침 토큰 업데이트하기 섹션을 참조하십시오.

SQL 명령을 사용하여 새로 고침 토큰 업데이트하기

SQL 명령을 사용하여 새로 고침 토큰을 업데이트하려면 다음을 수행하십시오.

  1. OAuth 새로 고침 토큰 을 가져옵니다. 커넥터가 현재 사용하고 있는 것과 동일한 client_id, client_secret 및 사용자 자격 증명을 사용해야 합니다.

  2. GLOBAL_CONFIG 뷰 를 쿼리하여 시크릿 오브젝트의 정규화된 이름을 찾습니다.

    SELECT value:secret FROM GLOBAL_CONFIG WHERE key = 'connection_config';
    
    Copy
  3. ALTER SECRET 명령을 실행하고 다음 매개 변수를 변경하여 시크릿 오브젝트를 업데이트합니다.

    • OAUTH_REFRESH_TOKEN 을 첫 단계에서 검색한 OAuth 새로 고침 토큰으로 설정합니다.

    • UTC 타임존에서 OAUTH_REFRESH_TOKEN_EXPIRY_TIME 을 새로 고침 토큰 만료 타임스탬프로 설정합니다. 새로 고침 토큰이 발행된 날짜에 ServiceNow의 토큰 수명을 추가하여 이를 계산할 수 있습니다. 기본적으로, 토큰은 100일 후에 만료됩니다.

    예를 들어 secretsdb.apiauth.servicenow_creds_oauth_code 시크릿을 업데이트하려면 다음 명령을 실행하십시오.

    ALTER SECRET secretsdb.apiauth.servicenow_creds_oauth_code SET OAUTH_REFRESH_TOKEN = '34n;vods4nQsdg09wee4qnfvadH', OAUTH_REFRESH_TOKEN_EXPIRY_TIME = '2022-01-06 20:00:00';
    
    Copy

    참고

    시크릿을 업데이트하려면 OWNERSHIP 권한이 있는 역할을 사용해야 합니다.

기본 인증을 위해 ServiceNow 비밀번호 업데이트하기

비밀번호를 업데이트하려면 기존 시크릿을 찾아 ALTER SECRET 명령을 사용해 수정해야 합니다.

  1. Snowsight 또는 SQL 명령을 사용하여 시크릿 오브젝트의 정규화된 이름을 확인합니다.

    Snowsight 를 사용하여 시크릿을 얻으려면 다음을 수행하십시오.

    1. ACCOUNTADMIN 역할을 가진 사용자로 Snowsight 에 로그인합니다.

    2. 탐색 메뉴에서 Data Products » Marketplace 를 선택합니다.

    3. Snowflake Connector for ServiceNow® 를 검색한 다음 커넥터에 알맞은 타일을 선택합니다.

    4. Connections 에서 ServiceNow 레이블 오른쪽 옆에 있는 ellipses 를 선택한 다음 View details 를 선택합니다.

      시크릿 오브젝트를 보여주는 ServiceNow Connection Configuration 대화 상자가 표시됩니다(예: CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET).

    SQL 명령을 사용하여 시크릿을 얻으려면 GLOBAL_CONFIG 뷰 를 쿼리하십시오.

    SELECT VALUE:secret FROM GLOBAL_CONFIG WHERE KEY = 'connection_config';
    
    Copy
  2. 커넥터를 중지합니다.

  3. ALTER SECRET 명령을 실행하고 PASSWORD 매개 변수를 변경하여 시크릿 오브젝트를 업데이트합니다.

    예를 들어 secretsdb.apiauth.servicenow_basic_auth 시크릿을 업데이트하려면 다음 명령을 실행하십시오.

    ALTER SECRET secretsdb.apiauth.servicenow_basic_auth SET PASSWORD = 'W3dr@fg*7B1c4j';
    
    Copy
  4. 커넥터를 재개합니다.

    이제 비밀번호가 업데이트되어 커넥터에서 사용됩니다.

참고

비밀번호 변경과 마찬가지로 ALTER SECRET 명령을 사용하여 사용자 이름을 업데이트하는 옵션이 있습니다. USERNAME 매개 변수를 새 사용자 이름으로 설정하기만 하면 됩니다. 사용자 이름을 변경하기 전에 새 사용자 이름이 최소한 이전 사용자 이름과 동일한 권한을 가지고 있는지 확인하십시오. 그렇지 않으면 커넥터가 제대로 작동하지 않을 수 있습니다.

Snowsight를 사용하여 설치하는 동안 생성된 오브젝트 삭제하기

커넥터 데이터베이스를 제거해도 별도의 데이터베이스에 저장된 수집 데이터나 Snowsight 를 사용하여 수행된 설치 중에 생성된 오브젝트는 삭제되지 않습니다.

설치 중에 생성된 오브젝트를 보려면 다음을 수행하십시오.

  1. ACCOUNTADMIN 역할을 가진 사용자로 Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 Data Products » Marketplace 를 선택합니다.

  3. ServiceNow®용 Snowflake 커넥터를 검색하여 선택합니다.

  4. Snowflake Connector for ServiceNow® 페이지에서 Connector Objects 영역을 찾습니다.

해당 오브젝트를 삭제하려면 DROP 명령을 실행하십시오.

예를 들어 시크릿을 삭제하려면 DROP SECRET 문을 실행하십시오.

설치 중에 생성된 오브젝트를 수동으로 제거하고 삭제하기

커넥터 데이터베이스를 제거해도 별도의 데이터베이스에 저장된 수집 데이터도, 커넥터를 설치할 때 만든 오브젝트도 삭제되지 않습니다. 다음과 같은 오브젝트가 이에 해당합니다.

해당 오브젝트를 삭제하려면 DROP 문을 실행하십시오. 예를 들어 시크릿을 삭제하려면 DROP SECRET 문을 실행하십시오.

Snowflake Connector for ServiceNow® 를 삭제하려면 DROP DATABASE 를 사용하십시오.

DROP DATABASE <database_name>;
Copy

Where

database_name

커넥터 설치 중에 생성된 데이터베이스의 이름을 지정합니다.

예를 들어 my_connector_servicenow 라는 데이터베이스에 설치된 커넥터를 삭제하려면 다음 명령을 실행하십시오.

DROP DATABASE my_connector_servicenow;
Copy

테이블 삭제하기

(예를 들어 실수로 활성화된) 테이블을 삭제하고 커넥터 모니터링용 뷰 에 표시하지 않으려면 다음 프로시저를 사용하십시오.

CALL DELETE_TABLE('<table_name>');
Copy

여기서

table_name

삭제할 테이블의 이름을 지정합니다. 이 테이블은 비활성화 해야 하며 다시 로드 하는 과정에 있으면 안 됩니다.

참고

DELETE_TABLE 프로시저는 Snowflake의 ServiceNow 데이터(원시 데이터 테이블, 이벤트 로그 테이블, 평면화 뷰)가 포함된 데이터베이스와 스키마에 이 테이블을 위해 생성된 오브젝트를 제거하지 않습니다. 이러한 오브젝트를 수동으로 삭제할 수 있습니다.

커넥터 업그레이드하기

이 섹션에서는 Snowflake 계정에서 커넥터를 업그레이드하는 방법을 설명합니다.

현재, 커넥터는 자동으로 업그레이드되지 않습니다. 커넥터를 최신 버전으로 업그레이드하려면 RUN_UPGRADE 라는 프로시저를 호출하십시오.

CALL RUN_UPGRADE();
Copy

(다른 사람이 동시에 커넥터를 구성하지 않는 한) 언제든지 이 업그레이드를 수행할 수 있습니다.

업그레이드가 빨리 완료되어야 합니다. 업그레이드하면 ServiceNow 데이터 수집이 일시적으로 비활성화됩니다. 업그레이드가 완료되면 커넥터가 데이터 수집을 재개합니다.

참고

업그레이드를 실행할 때 아무도 커넥터를 동시에 구성하지 않는다는 점을 확인하십시오.

ServiceNow 데이터에 대해 동일한 데이터베이스와 스키마로 커넥터 다시 설치하기

커넥터를 제거했지만 수집된 데이터가 포함된 데이터베이스와 스키마는 그대로 둔 경우 나중에 커넥터를 다시 설치하고 커넥터가 마지막으로 실행된 지점부터 데이터 수집을 재개할 수 있습니다.

참고

데이터 일관성을 보장하려면 현재 수집이 완료될 때까지 기다렸다가 커넥터를 중지한 후 커넥터를 제거하십시오.

  1. TABLES_STATE 뷰를 쿼리하고 현재 RUNNING 상태인 테이블이 없는지 확인합니다.

    SELECT * FROM TABLES_STATE;
    
    Copy
  2. 커넥터가 데이터를 수집하는 중인 경우 수집이 완료될 때까지 기다리십시오. 이는 전체 데이터 일관성을 보장하는 데 중요합니다.

  3. 현재 진행 중인 수집이 없으면 다음 저장 프로시저를 호출하여 커넥터를 중지합니다.

CALL STOP_CONNECTOR();
Copy

커넥터를 제거 한 후 다음 방법으로 커넥터를 다시 설치할 수 있습니다.

설치 프로세스 중에 다음을 수행합니다.

  • 이전에 사용한 데이터베이스와 스키마를 제공합니다.

  • 동일한 ServiceNow 인스턴스 URL을 제공합니다.

다른 인자의 경우 커넥터를 설치할 때 만든 오브젝트 를 재사용하거나 새 오브젝트를 사용할 수 있습니다.

참고

또한 동기화를 위해 ServiceNow 테이블을 활성화하는 단계를 포함하여 커넥터를 구성하는 단계 를 다시 반복해야 합니다.

새 오브젝트를 만들거나 커넥터에 대한 새 사용자 지정 역할 을 만드는 경우 역할에 필수적인 권한이 있는지 확인해야 합니다. 자세한 내용은 다음 섹션을 참조하십시오.

새 커넥터에 동일한 사용자 지정 역할 재사용하기

커넥터의 이전 설치에서 사용한 것과 동일한 커넥터에 대한 사용자 지정 역할 을 사용하는 경우 커넥터를 처음 설치할 때 생성한 오브젝트에 필요한 권한만 부여하면 됩니다. 역할에는 수집된 데이터를 포함하는 데이터베이스와 스키마의 테이블과 뷰를 포함하여 재사용 중인 다른 오브젝트에 대한 필수 권한이 이미 있어야 합니다.

또한 새 설치의 일부로 커넥터에 사용자 지정 역할을 부여 해야 합니다.

참고

사용자 지정 역할을 통해 CREATE OR REPLACE ROLE을 실행할 경우 역할은 기술적으로 동일한 이름을 가진 새 오브젝트입니다. 아래 섹션의 단계를 따라야 합니다.

새 커넥터에 새 사용자 지정 역할 사용하기

재설치된 커넥터에 대해 새 사용자 지정 역할을 사용하려는 경우 커넥터에 대한 사용자 지정 역할 만들기 아래에 나열된 모든 권한을 해당 역할에 부여해야 하며, 새 역할이 수집된 데이터를 포함한 스키마와 데이터베이스의 테이블과 뷰에 대한 필수 권한을 가지고 있도록 보장해야 합니다.

필수 권한을 부여하려면 이 스키마의 테이블 및 뷰의 OWNERSHIP을 새 사용자 지정 역할에 부여합니다.