커넥터 문제 해결하기¶

인증 단계 오류¶

설치 마법사에서 ServiceNow에 연결 하거나 SET_CONNECTION_CONFIGURATION 프로시저를 수동으로 실행할 때 문제가 발생할 수 있습니다. 이 단계에서 오류가 발생하면 커넥터를 설치하는 데 사용한 사용자에게 sys_db_object 테이블에 대한 액세스 권한이 있는지 확인하십시오.

SET_CONNECTION_CONFIGURATION 프로시저에서 반환된 JSON 오브젝트의 ACL 문제와 관련이 있을 수 있는 오류 상태 코드는 다음과 같습니다.

• REQUEST_FAILED

커넥터의 쿼리와 유사한 아래 쿼리를 수행하여 액세스를 확인할 수 있습니다. 요청이 예상한 결과를 반환해야 커넥터를 설치할 수 있습니다. 예를 들어 curl을 사용하여 HTTP 요청을 보내는 경우 다음을 실행하십시오.

# checking access to the sys_db_object table
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_db_object?sysparm_limit=1"

여기서

servicenow_instance

ServiceNow®의 이름을 지정합니다.

username 및 password

ServiceNow® 인스턴스에 대한 자격 증명을 지정합니다.

응답 예시:

• 최소한 일부 필드가 반환되는데, 사용자는 테이블에 액세스하는 데 필요한 권한이 있습니다.

• 응답이 비어 있습니다. 사용자는 테이블에는 액세스할 수 있는 권한이 있지만 처리된 레코드에는 액세스할 권한이 없습니다. 이로 인해 나중에 문제가 발생할 수도 있습니다.

• 응답에 오류가 있습니다. 사용자에게 테이블에 액세스하는 데 필요한 권한이 없습니다.

원본 검증 단계 오류¶

설치 마법사에서 원본을 검증 하거나 FINALIZE_CONNECTOR_CONFIGURATION 프로시저를 수동으로 실행할 때 문제가 발생할 수 있습니다. 이 단계에서 오류가 발생한 경우 커넥터를 설치하는 데 사용한 사용자에게 메타데이터 테이블에 액세스하는 데 필요한 권한이 있는지 확인하십시오.

FINALIZE_CONNECTOR_CONFIGURATION 프로시저에서 반환된 JSON 오브젝트의 ACL 문제와 관련이 있을 수 있는 오류 상태 코드는 다음과 같습니다.

• METADATA_TABLE_ACCESS_VALIDATION_ERROR

• JOURNAL_TABLE_ACCESS_VALIDATION_ERROR

커넥터의 쿼리와 유사한 아래 쿼리를 수행하여 액세스를 확인할 수 있습니다. 요청이 예상한 결과를 반환해야 커넥터를 설치할 수 있습니다. 예를 들어 curl을 사용하여 HTTP 요청을 보내는 경우 다음을 실행하십시오.

# checking access to the sys_db_object table
# expected fields in the result object: sys_id, super_class, name
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_db_object?sysparm_fields=sys_id,super_class,name&sysparm_limit=1&sysparm_query=name=sys_db_object"

# checking access to the sys_dictionary table
# expected fields in the result object: sys_id, name, element, internal_type
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_dictionary?sysparm_fields=sys_id,name,element,internal_type&sysparm_limit=1&sysparm_query=name=sys_dictionary"

# checking access to the sys_glide_object table
# expected fields in the result object: sys_id, name, scalar_type
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_glide_object?sysparm_fields=sys_id,name,scalar_type&sysparm_limit=1&sysparm_query=name=datetime"

# checking access to the sys_table_rotation table
# expected fields in the result object: sys_id, name
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_table_rotation?sysparm_fields=sys_id,name&sysparm_limit=1&sysparm_query=name=syslog"

# (optional) - check only if deletions auditing is going to be used
# checking access to the journal table
# if known, "&sysparm_query=tablename=<table_name>" or "&sysparm_query=documentkey=<sys_id>" can be appended to the request
# expected fields in the result object: sys_id, sys_created_on, documentkey, tablename
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/<journal_table>?sysparm_fields=sys_id,sys_created_on,documentkey,tablename&sysparm_limit=1"

여기서

servicenow_instance

ServiceNow®의 이름을 지정합니다.

username 및 password

ServiceNow® 인스턴스에 대한 자격 증명을 지정합니다.

journal_table

삭제 감사에 사용되는 ServiceNow® 테이블의 이름을 지정합니다. 보통 sys_audit_delete 의 값을 갖습니다.

응답 예시:

• 모든 예상 필드가 응답에 포함되어 있습니다. 즉, 사용자에게 필요한 권한이 있습니다.

• 예상되는 필드 중 일부가 없습니다. 사용자에게 모든 열에 대해 필요한 권한이 없습니다.

• 응답이 비어 있습니다. 사용자에게 모든 행에 대한 필수 권한이 없습니다.

• 응답에 오류가 있습니다. 사용자에게 테이블에 대한 필수 권한이 없습니다.

문제 해결 데이터 가져오기¶

문제 해결 데이터를 가져오려면 GET_TROUBLESHOOTING_DATA 저장 프로시저를 호출합니다.

CALL GET_TROUBLESHOOTING_DATA(<from_timestamp>, <to_timestamp>);

여기서

from_timestamp

데이터를 가져올 날짜 범위의 시작(UTC 타임존)을 지정합니다.

to_timestamp

데이터를 가져올 날짜 범위의 끝(UTC 타임존)을 지정합니다.

이 저장 프로시저는 다음 데이터를 테이블 형식으로 반환합니다.

• 구성 정보

• 커넥터에서 발생한 오류

• 수집 기록

다음 예제에서는 이 저장 프로시저를 호출하는 방법을 보여줍니다.

CALL GET_TROUBLESHOOTING_DATA('2024-02-05 10:00:00', '2024-02-10 22:30:00');

반환된 데이터를 CSV 형식으로 저장하여 Snowflake 지원 으로 보낼 수 있습니다.

커넥터 웨어하우스 복원하기¶

커넥터가 웨어하우스에 대한 액세스 권한을 상실한 경우, UPDATE_WAREHOUSE 저장 프로시저를 호출하여 새 커넥터를 구성합니다.

ServiceNow® 데이터에 대한 데이터베이스 및 스키마 복원하기¶

ServiceNow® 데이터에 대한 데이터베이스 또는 스키마 가 삭제된 경우, 복원할 수 있는 유일한 방법은 UNDROP 명령을 실행하는 것입니다. 이 명령을 사용할 수 없는 경우 커넥터를 다시 설치하고 ServiceNow® 데이터를 다시 수집해야 합니다.

ServiceNow® 데이터가 포함된 뷰 가 삭제된 경우, 생성을 담당하는 백그라운드 작업이 다음 번에 실행될 때 이 뷰가 자동으로 다시 생성되어야 합니다.

ServiceNow® 데이터(이벤트 로그 또는 원시 데이터 테이블)가 포함된 테이블 중 하나가 삭제되고 UNDROP TABLE 명령을 사용하여 이를 복구할 수 없는 경우, 다음을 수행하여 ServiceNow® 테이블의 수집을 다시 시작합니다.

• 이 ServiceNow® 테이블의 이벤트 로그와 원시 데이터 테이블이 모두 삭제되었는지 확인합니다.

• ServiceNow® 테이블을 비활성화 합니다.

• DELETE_TABLE 프로시저 를 사용합니다.

• ServiceNow® 테이블을 활성화 합니다

커넥터에 대한 알림 통합 복원하기¶

알림 통합 오브젝트에 대한 커넥터의 액세스 권한이 상실된 경우, 경고 구성 절차를 다시 수행하고 필요한 경우 알림 통합 오브젝트를 다시 생성하십시오.

이메일 알림이 Snowsight 를 통해 구성된 경우 알림을 비활성화한 후 다시 활성화하여 필요한 외부 오브젝트를 복원할 수 있습니다.

Snowflake에 열 메타데이터가 있는지 확인하기¶

열 메타데이터가 Snowflake의 sys_dictionary 테이블에 있는지 확인하려면 다음 쿼리를 실행합니다.

SELECT * FROM <dest_db>.<dest_schema>.sys_dictionary__view WHERE name = '<table_name>' AND element = '<column_name>';

조사 중인 테이블에 상위 테이블(ServiceNow®의 다른 테이블에서 상속된 테이블)이 있고 찾고 있는 열이 상위 테이블에 추가된 경우, 상위 테이블 이름을 대신 사용해야 합니다.

관심 있는 테이블이 상속하는 모든 테이블을 나열하려면 다음 쿼리를 사용합니다.

SELECT
    sys_id,
    name,
    PARSE_JSON(super_class):value::string AS super_class_sys_id
FROM <dest_db>.<dest_schema>.sys_db_object__view
START WITH name = '<table_name>'
CONNECT BY sys_id = PRIOR super_class_sys_id;

행이 반환되면 해당 열의 메타데이터가 Snowflake에 올바르게 수집되었지만 뷰가 아직 새로 고쳐지지 않은 것입니다. 상태를 확인하고 다음을 확인합니다.

• 최근에 뷰를 새로 고쳤지만, 여전히 열이 표시되지 않는다면 지원팀에 문의하십시오.

• 뷰가 아직 새로 고쳐지지 않았다면 다음 수집 일정을 기다립니다.

빈 결과가 반환되면 커넥터가 아직 해당 열에 대한 메타데이터를 수집하지 않은 것입니다. 레코드가 커넥터에 표시되고 올바른 타임스탬프가 있는지 ServiceNow® 측에서 확인해야 합니다.

새로 고침 상태 보기¶

지정된 테이블에 대한 뷰가 마지막으로 새로 고쳐진 시점과 작업이 성공했는지 확인하려면 다음 쿼리를 실행합니다.

SELECT flattened_views_status, flattened_views_last_updated FROM tables_state WHERE table_name = '<table_name>';

마지막 새로 고침이 실패한 경우 이벤트 테이블을 쿼리하여 커넥터에서 보고된 오류를 찾아볼 수 있습니다.

ServiceNow® 열 메타데이터 사용 가능 여부 보기¶

평면화된 뷰에서 열이 누락되는 이유는 커넥터가 열 메타데이터를 수집할 수 없기 때문일 수 있습니다. 이는 ACLs가 sys_dictionary 테이블의 행을 Table API에서 반환하지 못하도록 방지하기 때문에 발생할 수 있습니다. 또 다른 가능한 이유는 sys_updated_on 열의 과거 타임스탬프 값입니다. 열/테이블 정의를 다른 ServiceNow® 인스턴스에서 가져온 경우일 수도 있습니다. 커넥터가 열 메타데이터에 액세스할 수 있는지 확인하려면 다음 엔드포인트에 GET 요청을 실행합니다.

https://<servicenow_instance>.service-now.com/api/now/table/sys_dictionary?sysparm_query=name=<table_name>^element=<column_name>

빈 결과가 반환되면 커넥터가 열에 액세스할 수 없습니다. 열은 ACL로 보호되거나 표시되지 않을 수 있습니다.

열 정의가 반환된 경우 sys_updated_on 필드의 값을 확인합니다. 열이 테이블에 추가될 것으로 예상된 시간과 날짜가 일치하는지 확인합니다. 다른 인스턴스에서 가져온 것이라면 열이 생성된 시점이 표시될 수 있습니다. 커넥터의 CDC(증분 업데이트) 메커니즘이 과거 날짜의 레코드가 추가되었음을 인식하지 못할 수 있습니다. 이 경우 sys_dictionary 테이블의 재로드를 트리거합니다.