JDBC 연결 구성

type: jdbc는 JDBC URL과 드라이버 클래스 이름으로 외부 데이터베이스에 연결합니다. URL은 Foundry 워커에서 접근할 수 있는 실제 데이터베이스 주소를 사용합니다.

jdbcProperties는 드라이버의 일반 속성 맵입니다. 비밀번호는 이 맵에 넣지 않고 credentials.password의 암호화 속성으로 전달합니다. 사용자 지정 JAR은 연결을 만든 뒤 드라이버 업로드로 등록합니다.

생성 입력의 필드

이름	자료형	필수 여부	의미와 조건	예시 값
`type`	`enum`	필수	분기를 구분하는 `type` 값입니다. 허용값: `jdbc`.	`jdbc`
`credentials`	`object`	선택
`driverClass`	`string`	필수	데이터베이스 연결에 사용하는 드라이버 클래스의 완전한 이름입니다.	`org.postgresql.Driver`
`jdbcProperties`	`map<string, string>`	선택	JDBC 드라이버에 전달할 일반 속성 맵입니다. 추가 속성은 해당 드라이버의 계약을 따릅니다. 비밀값용 암호화 속성이 아니므로 비밀번호나 키를 이 맵에 넣지 않습니다.
`url`	`string`	필수	JDBC 드라이버가 데이터베이스에 연결할 때 사용하는 URL입니다.	`jdbc:postgresql://db.example.com:5432/example`

이름	자료형	필수 여부	의미와 조건	예시 값
`username`	`string`	필수
`password`	`EncryptedProperty`	필수	조회 시에는 암호화된 값 대신 비밀 이름을 반환합니다. 쓸 때 평문 값을 전달하면 암호화하여 저장합니다. 비밀 이름을 전달하면 해당 속성의 기존 비밀 이름과 같아야 하며 기존 암호화 값을 유지합니다.

입력과 조회에서 사용하는 값의 차이 및 두 분기의 전체 구조는 암호화 속성을 따릅니다.

생성 입력에는 uploadedJdbcDrivers를 넣지 않습니다. 연결 구성을 조회하면 업로드한 아티팩트 이름 목록이 선택 필드로 반환됩니다.

이름	자료형	필수 여부	의미와 조건	예시 값
`uploadedJdbcDrivers`	`list<JdbcDriverArtifactName>`	선택	업로드한 JDBC 드라이버 이름 목록입니다. 드라이버는 `uploadCustomJdbcDrivers`로 업로드합니다.

배열 항목은 JdbcDriverArtifactName이며 자료형은 string입니다.

업로드한 JDBC 아티팩트의 이름입니다.

다음 값은 지정한 필드에 넣는 가상 입력 구조입니다. 전체 연결 생성 요청과 구분하고, 실제 호스트와 역할, 자격 증명 및 드라이버가 지원하는 속성으로 바꿉니다.

{
  "password": {
    "type": "asPlaintextValue",
    "value": "myPlaintextSecret"
  },
  "username": "example-user"
}

{
  "propertyName1": "propertyValue1",
  "propertyName2": "propertyValue2"
}