Snowsight로 커넥터 설치 및 구성하기¶
ServiceNow®용 Snowflake 커넥터에는 커넥터 약관 이 적용됩니다.
이 항목에서는 Snowsight를 통해 Snowflake Connector for ServiceNow® 를 설치하고 구성하는 방법에 대한 정보를 제공합니다.
이 항목의 내용:
Snowflake Connector for ServiceNow® 설치하기¶
다음 절차에서는 커넥터를 설치하는 방법을 설명합니다.
ACCOUNTADMIN 역할을 가진 사용자로 Snowsight 에 로그인합니다.
탐색 메뉴에서 Data Products » Marketplace 를 선택합니다.
ServiceNow®용 Snowflake 커넥터를 검색한 다음 커넥터에 알맞은 타일을 선택합니다.
Snowflake Connector for ServiceNow® 페이지에서 Get 을 선택합니다.
그러면 설치 프로세스의 초기 부분을 시작하는 데 사용하는 대화 상자가 표시됩니다.
대화 상자에서 다음을 구성합니다.
Database name 필드에 커넥터 인스턴스의 데이터베이스로 사용할 데이터베이스의 이름을 입력합니다. 이 데이터베이스는 자동으로 생성됩니다.
Warehouse used for installation 필드에서 커넥터 설치에 사용할 웨어하우스를 선택합니다.
참고
이것은 커넥터가 ServiceNow에서 데이터를 동기화하는 데 사용하는 것과 동일한 웨어하우스가 아닙니다. 이후 단계에서 이 목적으로 별도의 웨어하우스를 생성합니다.
Which roles, in addition to ACCOUNTADMIN, can access this database? 필드에서 데이터베이스에 액세스하려는 다른 역할을 추가합니다.
Get 을 선택합니다.
<Your database name> is now ready to use in your account.
알림과 함께 대화 상자가 나타납니다. 구성을 계속하려면 Manage 를 선택하십시오.대화 상자가 닫히고 Snowflake Connector for ServiceNow® 페이지에 커넥터 구성과 관리를 위한 UI가 표시됩니다.
ServiceNow에 대한 연결 설정하기¶
다음 절차에서는 ServiceNow에 대한 연결을 설정하는 방법을 설명합니다.
Connections 섹션에서 Connect 를 선택하여 ServiceNow 인스턴스에 연결하는 설정을 구성합니다.
그러면 Connect to ServiceNow 대화 상자가 표시됩니다.
ServiceNow Instance 필드에 ServiceNow 인스턴스의 이름을 입력합니다.
이는 ServiceNow 인스턴스의 호스트 이름 중 첫 번째 부분입니다. 예를 들어 ServiceNow 인스턴스에 대한 URL이 다음과 같은 경우
https://myinstance.service-now.com
인스턴스 이름은
myinstance
가 됩니다.Authentication Method 필드에서 커넥터가 ServiceNow 인스턴스에 연결할 수 있도록 허용하는 데 사용할 인증 방법을 선택합니다.
기본 인증(사용자 이름 및 비밀번호) 또는 OAuth 중에서 선택할 수 있습니다.
Basic authentication 을 선택한 경우 ServiceNow username 및 ServiceNow password 필드에 ServiceNow 계정의 자격 증명을 입력합니다.
OAuth 를 선택한 경우 ServiceNow에 애플리케이션 레지스트리를 생성하고 이를 사용하여 커넥터를 구성합니다.
애플리케이션 레지스트리를 만들려면 다음을 수행하십시오.
ServiceNow 인스턴스에 로그인한 다음 Homepage 를 선택합니다.
OAuth를 검색한 다음 Application Registry 를 선택합니다.
New, 를 선택한 다음 Create an OAuth API endpoint for external clients 를 선택합니다.
그러면 다음 이미지와 같이 애플리케이션 레지스트리에 대한 구성 페이지가 표시됩니다.
ServiceNow에서 Name 필드에 OAuth 애플리케이션 레지스트리의 이름을 입력합니다.
커넥터 UI에서 Redirect URL 필드의 값을 복사합니다.
이 값은 커넥터에서 생성된 값입니다.
ServiceNow에서 이 값을 Redirect URL 필드에 붙여넣습니다.
필요한 경우 ServiceNow에서 Refresh Token Lifespan 및 Access Token Lifespan 필드의 값을 업데이트합니다.
액세스 토큰의 수명을 600초 이상으로 설정하는 것이 좋습니다.
새로 고침 토큰의 수명 값을 7776000(90일)으로 지정합니다.
ServiceNow 에서 Submit 를 선택합니다.
OAuth 애플리케이션 레지스트리가 애플리케이션 레지스트리 목록에 나타납니다.
ServiceNow에서 방금 생성한 애플리케이션 레지스트리를 선택합니다.
ServiceNow가 Client ID 및 Client Secret 필드의 값을 생성했습니다.
ServiceNow에서 Client ID 의 값을 복사합니다.
커넥터 UI의 Client ID 필드에 이 값을 붙여넣습니다.
ServiceNow에서 Client Secret 의 값을 복사합니다.
커넥터 UI의 Client Secret 필드에 이 값을 붙여넣습니다.
커넥터는 시크릿 (스키마 수준 오브젝트의 한 유형)을 사용하여 ServiceNow 인스턴스를 인증하는 데 사용되는 액세스 토큰을 저장합니다. 커넥터는 보안 통합 및 API 통합과 함께 이 시크릿 오브젝트를 사용하여 ServiceNow 인스턴스에 연결합니다.
시크릿, 보안 통합, API 통합은 커넥터를 설치할 때 자동으로 생성됩니다.
시크릿 오브젝트, 보안 통합, API 통합의 구성 방법을 지정하려면 Advanced Settings 를 선택하고 다음 필드를 채우십시오.
필드
설명
Secret Name
시크릿의 이름입니다. 커넥터가 이 값을 생성합니다. 이 값은 변경할 수 없습니다.
Authorization URL
ServiceNow 인스턴스를 인증하기 위한 URL입니다. 이 URL는 다음 형식이어야 합니다.
https://<instance_name>.service-now.com/oauth_token.do
여기서
instance_name
은 ServiceNow 인스턴스의 이름입니다.Token URL
ServiceNow 인스턴스에 대한 새로 고침 토큰을 요청하기 위한 URL입니다. 이 URL은 다음 형식이어야 합니다.
https://<instance_name>.service-now.com/oauth_token.do
여기서
instance_name
은 ServiceNow 인스턴스의 이름입니다.Allowed Prefix
ServiceNow 인스턴스의 URL입니다.
이는 이러한 연결 설정의 사용을 제한합니다. 이 설정은 지정된 접두사가 있는 URL에 연결하는 데만 사용할 수 있습니다.
커넥터 UI에서 Connect 를 선택합니다.
사용자 이름과 비밀번호를 사용하여 ServiceNow 인스턴스에 로그인하라는 대화 상자가 나타납니다. 커넥터가 인증하도록 할 사용자의 자격 증명을 제공하십시오. 커넥터는 ServiceNow® 인스턴스 준비하기 에 나열된 권한이 있어야 합니다.
로그인한 후 커넥터가 ServiceNow 계정에 연결할 수 있도록 허용할지 확인하십시오. Allow 를 선택합니다.
참고
자격 증명을 제공할 필요 없이 이 대화 상자로 직접 리디렉션되었다면 이미 ServiceNow 인스턴스에 로그인되어 있는 것입니다. 커넥터가 사용해야 하는 동일한 사용자로 로그인했고 해당 사용자에게 필요한 권한이 있는지 확인하십시오. 참고: 현재 로그인된 사용자는 대화 상자의 오른쪽 상단에 표시됩니다.
새 ServiceNow 연결이 Connection 영역에 나타납니다.
이러한 단계의 결과, 마법사는 커넥터가 작동하는 데 필요한 커넥터 데이터베이스 외부에 상주하는 다음 오브젝트를 만듭니다.
시크릿 오브젝트를 저장하는 데 사용되는 스키마
SERVICENOW_GZSTZTP0KHD
가 포함된 데이터베이스CONNECTORS_UI
,ServiceNow 자격 증명이 있는
SECRET
이라는CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD
의 시크릿 오브젝트,OAuth 인증이 승인 방법으로 선택된 경우 Snowflake와 타사 OAuth 2.0 서비스 사이의 통합에 사용되는
SERVICENOW_GZSTZTP0KHD_INTEGRATION
이라는 보안 통합,API 통합
SERVICENOW_GZSTZTP0KHD_API
는 ServiceNow와의 통신에 사용됩니다.
이러한 오브젝트의 이름은 변경하면 안 됩니다. 커넥터는 이러한 오브젝트를 이름으로 참조합니다. 이름을 변경하거나 삭제하면 참조가 끊어지고 커넥터의 연결이 끊어집니다.
Snowflake Connector for ServiceNow® 구성하기¶
ACCOUNTADMIN 역할을 가진 사용자로 Snowsight 에 로그인합니다.
탐색 메뉴에서 Data Products » Marketplace 를 선택합니다.
Snowflake Connector for ServiceNow® 를 검색한 다음 선택합니다.
커넥터 상태 아래에서 Configure 를 선택합니다.
그러면 Configure Connector 대화 상자가 표시됩니다.
참고
기본적으로, 필드는 커넥터를 구성할 때 생성되는 오브젝트의 이름으로 설정됩니다. 이러한 필드에 새 오브젝트를 사용하는 것이 좋습니다. 하지만 필요한 경우(예: 커넥터를 다시 설치하는 경우) 기존 오브젝트의 이름을 지정할 수 있습니다.
이 대화 상자에서 다음 필드를 채웁니다.
필드
설명
Warehouse
커넥터에 대한 새로운 전용 가상 웨어하우스의 식별자입니다.
계정에 고유한 이름을 지정하십시오. 웨어하우스 이름은 유효한 오브젝트 식별자 여야 합니다.
참고
커넥터 설치 시작 시 선택한 것과 동일한 웨어하우스를 지정하지 마십시오.
구성 프로세스에서는 지정된 이름으로 새
Large
웨어하우스를 생성합니다.Destination Database
Snowflake의 ServiceNow 데이터에 대한 테이블이 있는 스키마를 포함할 새 데이터베이스의 식별자입니다.
계정에 고유한 이름을 지정하십시오. 데이터베이스 이름은 유효한 오브젝트 식별자 여야 합니다.
구성 프로세스에서는 지정된 이름으로 새 데이터베이스를 생성합니다.
Destination Schema
Snowflake의 ServiceNow 데이터를 포함할 새 스키마의 식별자입니다.
Snowflake Connector for ServiceNow® 는 ServiceNow 데이터를 이 스키마의 테이블로 수집합니다.
계정에 고유한 이름을 지정하십시오. 스키마 이름은 유효한 오브젝트 식별자 여야 합니다.
구성 프로세스에서는 지정된 이름으로 새 스키마를 생성합니다.
Role
커넥터에 대한 새로운 사용자 지정 역할의 식별자입니다. 이 역할을 통해 커넥터는 다음을 수행할 수 있습니다.
데이터 수집을 위한 작업 생성 및 관리.
전용 웨어하우스 사용.
ServiceNow 인스턴스에 연결하기 위해 시크릿 및 API 통합에 액세스.
이 역할은 또한 커넥터가 수집한 ServiceNow 데이터를 포함하는 테이블과 뷰의 소유자입니다.
계정에 고유한 이름을 지정하십시오. 역할 이름은 유효한 오브젝트 식별자 여야 합니다.
구성 프로세스에서는 지정된 이름으로 새 역할을 생성합니다.
수집이 시작된 후 수집된 데이터에 액세스하기 위해 별도의 보다 세분화된 역할을 만드는 것이 좋지만, 이 역할을 사용하여 수집된 데이터를 쿼리하고 추가 권한으로 확장할 수 있습니다. 반대로, 커넥터에 필요한 오브젝트에 대한 역할 권한을 취소하거나 수집된 데이터가 있는 테이블 및 뷰의 역할 소유권을 변경하는 것은 허용되지 않으며 그럴 경우 커넥터가 중단됩니다.
Journal table
(선택 사항) 삭제된 레코드를 전파할 수 있도록 하려면 이 필드를 삭제된 레코드에 대한 정보 소스 역할을 하는 테이블로 설정합니다.
sys_audit_delete
테이블 또는 사용자 지정 저널 테이블을 삭제된 레코드에 대한 정보 소스로 사용할 수 있습니다.ServiceNow에서 삭제된 레코드를 Snowflake로 수집하지 않으려면 이 필드를 비워 두십시오.
참고
커넥터의 ServiceNow 사용자가 지정된 저널 테이블에 대한 액세스 권한이 있는지 확인하십시오.
Configure 를 선택합니다.
대화 상자가 닫히고 커넥터의 상태가 Provisioning 으로 변경됩니다. 구성 프로세스를 완료하는 데 몇 분 정도 걸릴 수 있습니다.
Connector Objects 섹션에는 설치 및 구성 중에 자동으로 생성된 오브젝트가 표시됩니다. 커넥터는 이러한 오브젝트를 사용하여 ServiceNow 인스턴스에서 데이터를 수집합니다. 오브젝트에 대한 세부 정보를 보려면 오브젝트를 선택하십시오.
구성 프로세스가 성공적으로 완료되면 표시된 상태가 Inactive 로 변경됩니다.
커넥터는 웨어하우스, 대상 데이터베이스, 대상 스키마, 역할을 이름으로 참조합니다. 이러한 오브젝트의 이름을 변경하거나 삭제하면 참조가 끊어지고, 그 결과로 커넥터의 연결도 끊어집니다. 웨어하우스 이름을 바꾸는 대신, CONFIGURE_WAREHOUSE 저장 프로시저를 사용하여 커넥터가 사용하는 웨어하우스를 변경하십시오.
구성 중 오류 문제 해결하기¶
구성 프로세스 중에 오류가 발생하면 커넥터 상태가 Incomplete 로 변경됩니다. 오류를 식별하고 해결하려면 다음을 수행하십시오.
구성 대화 상자를 다시 표시하려면 Retry Setup 을 선택하십시오.
필드 아래에서 오류 메시지를 확인하십시오.
필드의 문제를 수정하고 Configure 를 선택하여 구성 프로세스를 다시 시작합니다.
다음 단계¶
커넥터를 설치 및 구성한 후 ServiceNow® 데이터에 대한 데이터 수집 설정하기 에 설명된 단계를 수행합니다.