Smartsheet 연결과 인증
Smartsheet 커넥터는 원천 탐색, 배치 동기화, 증분 수집, OAuth 2.0 인증과 테이블 내보내기를 일반 제공(GA)합니다. 개인 액세스 토큰 또는 OAuth로 Smartsheet에 인증한 뒤 테이블 형태의 데이터를 수집합니다.
소스와 연결 속성
Data Connection의 +New Source에서 Smartsheet를 선택하고 워커와 JDBC properties를 설정합니다. URL 필드는 jdbc:smartsheet:로 고정되어 수정할 수 없습니다. JDBC URL 뒤에 연결 속성을 붙이는 대신 JDBC properties에 각 속성을 추가합니다.
| 속성 | 요구 수준 | 의미 | 기본값 |
|---|---|---|---|
UseLegacyAPI | 필수 | 테이블 메타데이터와 일부 열 메타데이터를 탐색할 API를 선택합니다. | FALSE |
AuthScheme | 권장 | Smartsheet 인증 방식입니다. | PersonalAccessToken |
InitiateOAuth | 권장 | OAuth 토큰 발급 또는 갱신 절차입니다. | REFRESH |
OAuthClientId | 권장 | 사용자 정의 OAuth 앱의 client ID이며 consumer key라고도 합니다. | 미지정 |
OAuthClientSecret | 권장 | 사용자 정의 OAuth 앱을 인증하는 client secret입니다. | 미지정 |
PersonalAccessToken | 권장 | Smartsheet 화면에서 발급한 개인 액세스 토큰입니다. | 미지정 |
Region | 권장 | Smartsheet 계정이 호스팅되는 리전입니다. | GLOBAL |
개인 토큰은 Smartsheet의 Account, Personal Settings, API Access에서 생성하거나 관리합니다. 이 방식에서는 AuthScheme=PersonalAccessToken과 발급한 PersonalAccessToken을 설정합니다.
URL 속성을 폼으로 옮기기
일반 JDBC 구성은 다음처럼 속성을 세미콜론으로 연결합니다. MyOAuthClientId와 MyOAuthClientSecret은 예시 값입니다.
jdbc:smartsheet:InitiateOAuth=GETANDREFRESH;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;
Foundry에서는 URL을 수정하지 않고 각각의 값을 JDBC properties에 넣습니다. OAuth를 선택하려면 AuthScheme=OAuth도 설정해야 합니다. 콜백에는 위의 로컬 호스트 예시를 그대로 쓰지 말고 Foundry 소스에서 자동 생성한 값을 사용합니다. GETANDREFRESH 예시와 Foundry 구성의 기본값 REFRESH는 토큰을 처음 발급할지 이미 승인한 토큰을 갱신할지에 따라 구분합니다.
리전별 외부 통신
대상별 외부 통신 정책을 추가합니다. Foundry에서 직접 연결할 수 없으면 에이전트 프록시 정책을 사용하고 에이전트 호스트의 접근도 확보합니다.
| 대상 | 필요 조건 |
|---|---|
api.smartsheet.com | Region=GLOBAL일 때 필요합니다. GLOBAL이 기본값입니다. |
api.smartsheet.eu | Region=EU일 때 필요합니다. |
api.smartsheetgov.com | Region=GOV일 때 필요합니다. |
app.smartsheet.com | GLOBAL 환경의 OAuth 승인 URL에만 사용합니다. |
app.smartsheet.eu | EU 환경의 OAuth 승인 URL에만 사용합니다. |
app.smartsheetgov.com | GOV 환경의 OAuth 승인 URL에만 사용합니다. |
OAuth 승인
OAuth 인증 코드 흐름은 Foundry 워커에서 사용합니다. 소스의 콜백 URL을 Smartsheet의 사용자 정의 OAuth 앱에 등록하고 client ID와 secret을 입력합니다. 소스를 저장한 뒤 소스 개요의 Authorize에서 승인합니다. 갱신과 철회는 소스 개요의 오른쪽 패널에서 관리합니다.
승인 시작, 갱신과 철회에는 기본적으로 Owner 역할이 필요합니다. Viewer 또는 Editor만 있으면 권한 오류가 발생합니다. OAuth 흐름과 ConnectOnOpen=true는 함께 사용할 수 없습니다.
수집과 내보내기
동기화에서는 테이블을 반환하는 SQL 질의 하나를 실행해 결과를 Foundry 데이터셋에 저장합니다. 테이블 내보내기는 기존 외부 테이블에 행을 추가하는 데 사용합니다.
CData 테이블 내보내기는 기존 데이터를 비우지 않는 모드만 지원합니다. 키 기준 갱신, 삭제나 upsert를 지원하지 않습니다. 운영 대상에 쓰기 전에 비운영 대상에 한 행을 시험하고 소스의 내보내기 설정과 대상 쓰기 권한을 확인합니다.