연결 구성의 생성 입력과 조회 결과
configuration.type은 연결할 외부 시스템과 설정 자료형을 구분합니다. Platform API의 연결 구성은 다음 여섯 분기를 사용합니다. Data Connection UI에서 제공하는 전체 커넥터 및 인증 옵션 목록과 구분합니다.
type | 상세 계약 |
|---|---|
s3 | 버킷, STS, 인증과 프록시 |
rest | 허용 도메인, 인증과 추가 비밀 |
snowflake | 계정, 기본 데이터베이스와 인증 |
databricks | 작업 공간, 컴퓨트 경로와 인증 |
smb | 공유, 도메인 인증과 메시지 서명 |
jdbc | 드라이버, URL, 일반 속성과 자격 증명 |
Create Connection은 생성 입력을 받고, Get Configuration은 조회 형태의 ConnectionConfiguration을 반환합니다. 비밀 속성은 EncryptedProperty의 입력과 조회 규칙을 따릅니다.
생성과 조회에서 달라지는 필드
| 구성 | 생성 입력 | 조회 결과의 추가 정보 |
|---|---|---|
Snowflake externalOauth | type만 지정 | 필수 audience, issuerUrl, subject |
Databricks workflowIdentityFederation | 필수 audience, 선택 servicePrincipalApplicationId | 필수 issuerUrl, subject |
| JDBC | URL, 드라이버 클래스, 선택 일반 속성과 자격 증명 | 선택 uploadedJdbcDrivers 목록 |
S3 oidc는 생성 입력에서도 audience, issuerUrl, subject를 모두 요구합니다. 위 두 페더레이션 구성과 같은 입력으로 축약하지 않습니다. 새 소스의 OIDC 식별 값을 아직 확보하지 못했다면 UI의 OIDC 설정을 통해 구성합니다.
연결의 상위 폴더, 표시 이름, 워커와 내보내기 설정은 Connection 자료형에 있습니다. 구성만 필요한 조회에서는 Get Configuration을 사용하고, 여러 연결의 구성은 배치 조회로 가져옵니다.