모든 마이그레이션 작업 가져오기

얻다 /jobs

모든 마이그레이션 작업 가져오기

쿼리 매개변수

sort 문자열

결과를 조회하는 순서

형식은 ^\w+,(DESC|ASC)$ 패턴 과 일치해야 합니다. 기본값은 submittedAt,DESC입니다.
limit integer

결과 제한

최소값은 0입니다.
유형 문자열

특정 작업 유형으로만 작업 필터링

값은 IN_PROGRESS입니다.
projectId 문자열

projectId로 작업 필터링

형식은 ^[A-Za-z0-9\-]+$ 패턴 과 일치해야 합니다.

응답

200 application/json

확인
응답 속성 숨기기 응답 속성 표시 객체
- id 문자열 필수 사항
  
  형식은 ^[A-Za-z0-9\-]+$ 패턴 과 일치해야 합니다.
- projectId 문자열 필수 사항
  
  형식은 ^[A-Za-z0-9\-]+$ 패턴 과 일치해야 합니다.
- 상태 문자열 필수 사항
  
  Values are NOT_STARTED, RUNNING, FAILED, CANCELLING, CANCELLED, COMPLETED, CLEANING_UP, or PAUSED.
- cdcStatus 문자열
  
  값은 NOT_STARTED, RUNNING, COMPLETING, COMPLETED, FAILED, CANCELLED 또는 PAUSED입니다. 기본값은 NOT_STARTED입니다.
- verifyJobId 문자열
- 옵션 객체 필수 사항
  
  추가 속성은 허용되지 않습니다.
  
  옵션 속성 숨기기 옵션 속성 표시 객체
  
  제거 컬렉션 부울
  
  기본값은 false 입니다.
  
  모드 문자열 필수 사항
  
  값은 SNAPSHOT, CDC, INCREMENTAL 또는 VERIFICATION입니다.
  
  truncationReportMode 문자열
  
  값은 FAIL, WARN 또는 SKIP입니다.
  
  errorHandling 문자열
  
  Debezium 오류가 예외를 발생시킬지 아니면 그냥 기록할지를 정의합니다. https://debezium.io/documentation/reference/stable/connectors/mysql.html#mysql-property-event-processing-failure-handling-mode
  
  값은 FAIL, WARN 또는 SKIP입니다.
  
  errorTolerance integer
  
  마이그레이션 종료하기 전에 허용해야 하는 장애( 기록 수준)의 횟수입니다. 값은 엄격하게 크거나 같습니다.
  
  최소값은 0입니다.
  
  incrementalSnapshotOptions 객체
  
  증분적 마이그레이션 모드에만 적용되는 옵션입니다.
  
  추가 속성은 허용되지 않습니다.
  
  incrementalSnapshotOptions 속성 숨기기 incrementalSnapshotOptions 속성 표시 객체
  
  signallingTable 문자열
  
  증분 스냅샷 조정하는 데 사용되는 소스 데이터베이스 의 신호 테이블입니다. 소스 연결에서 가져온 데이터베이스 세그먼트 또는 전체 데이터베이스 있는 스키마.table(MySQL: 데이터베이스 .table )을 허용합니다. 스키마.table 이름입니다.
  
  chunkSize integer
  
  증분 스냅샷 청크당 행 (데베지움 증분.snapshot.chunk.size). 생략하면 데베지움의 기본값 1024이 적용됩니다. 청크가 클 수록 더 빠르게 복사됩니다. 하지만 열린 청크 창다음 메모리에 더 많은 행이 저장됩니다.
  
  Minimum value is 1, maximum value is 100000.
- jdbcConnectionString 문자열
- MongoDB 연결 문자열 문자열
- submittedAt 문자열(날짜-시간) 필수 사항
- 통계학 객체
  
  추가 속성은 허용되지 않습니다.
  
  통계 속성 숨기기 통계 속성 표시 객체
  
  startedAt 문자열(날짜-시간)
  
  경과된 시간 integer(int64)
  
  나머지 테이블 수 integer
  
  processingTables array[string]
  
  migratedTables array[string]
  
  스냅샷 복사가 완료된 소스 테이블입니다. 완료는 소스 스냅샷 읽기가 완료되었음을 의미하지 모든 행이 성공적으로 마이그레이션되었음을 의미하지 않습니다. 실패하면 여기에 나열된 테이블이 failureError에도 표시될 수 있습니다.
  
  totalEventsSeen integer(int64)
  
  기본값은 0 입니다.
  
  snapshotCompleted 부울
  
  기본값은 false 입니다.
  
  totalTableCount integer
  
  totalEvents integer(int64)
  
  totalEventSize integer(int64)
- cdcStatistics 객체
  
  추가 속성은 허용되지 않습니다.
  
  cdcStatistics 속성 숨기기 cdcStatistics 속성 표시 객체
  
  startedAt 문자열(날짜-시간)
  
  lastEventTime 문자열(날짜-시간)
  
  lastEventSourceDatabaseTime 문자열(날짜-시간)
  
  EventsInLastHour integer(int64)
  
  기본값은 0 입니다.
  
  EventsInLastMinute integer(int64)
  
  기본값은 0 입니다.
  
  totalEventsSeen integer(int64)
  
  기본값은 0 입니다.
  
  최신BatchMaxSourceDbLagMs integer(int64)
  
  MongoDB 에 대한 완료된 각 배치 쓰기의 경우, 소스 데이터베이스 에 변경 사항이 발생한 시점( 데이터베이스 에서 보고한 바)부터 배치 쓰기 (write) 완료될 때까지의 최대 지연 시간입니다. 이는 소스 데이터베이스 클럭과 마이그레이션 이 실행 중인 시스템 간의 클럭 스큐의 영향을 받을 수 있습니다.
  
  기본값은 -1 입니다.
- jmxConnectivity 객체
  
  JMX 통계 스크래핑의 연결성(kafka-connect 배포 프로필에만 해당). 마이그레이터가 JMX를 통해 통계를 성공적으로 스크래핑하는지 여부와 마지막으로 스크래핑한 시간을 표시하여 잘못 구성되거나 연결할 수 없는 JMX 엔드포인트 또는 충돌한 연결 작업이 UI에 표시됩니다. JMX를 통해 통계를 읽지 않는 배포서버에는 없습니다.
  
  추가 속성은 허용되지 않습니다.
  
  jmxConnectivity 속성 숨기기 jmxConnectivity 속성 표시 객체
  
  상태 문자열 필수 사항
  
  값은 AVAILABLE 또는 UNAVAILABLE입니다.
  
  lastSuccessfulScrapeAt 문자열(날짜-시간)
  
  최근 성공적인 JMX 통계 스크래핑 시간.
  
  오류 메시지 문자열
  
  통계를 사용할 수 없을 때 최근 JMX 연결 오류가 발생합니다.
- connectorStatus 객체
  
  이 마이그레이션 작업을 지원하는 Kafka Connect 커넥터의 런타임 상태(kafka-connect / confluent 배포 프로필에만 해당)는 제출 시점에 성공을 가정하기보다는 Kafka Connect에서 보고된 실제 상태를 반영합니다. 연결이 FAILED 상태이면서 작업이 정상적인 것으로 보이는 대신 UI에서 문제가 있는 특정 커넥터/작업을 표시할 수 있습니다. Kafka Connect에 의해 지원되지 않는 배포서버에는 없습니다.
  
  추가 속성은 허용되지 않습니다.
  
  connectorStatus 속성 숨기기 connectorStatus 속성 표시 객체
  
  source 객체
  
  하나의 Kafka Connect 커넥터(소스 또는 싱크)와 작업의 런타임 상태.
  
  추가 속성은 허용되지 않습니다.
  
  소스 속성 숨기기 소스 속성 표시 객체
  
  이름 문자열
  
  Kafka Connect에 등록된 Connector 이름입니다.
  
  상태 문자열 필수 사항
  
  커넥터 또는 작업 중 하나에 대해 Kafka Connect가 보고한 런타임 상태(아래 https://kafka.apache.org/documentation/#connect_administration 참조). UNKNOWN은 Relational Migrator의 고유 값으로, Kafka Connect 워커에 액세스할 수 없는 경우와 같이 상태를 조회할 수 없을 때 사용됩니다.
  
  값은 RUNNING, PAUSED, FAILED, UNASSIGNED, RESTARTING, STOPPED 또는 UNKNOWN입니다.
  
  작업 배열[객체]
  
  이 커넥터의 작업별 런타임 상태.
  
  작업 속성 숨기기 작업 속성 표시 객체
  
  Kafka Connect에서 보고한 단일 Kafka Connect 작업의 런타임 상태입니다.
  
  id integer 필수 사항
  
  커넥터 내의 작업 ID.
  
  상태 문자열 필수 사항
  
  커넥터 또는 작업 중 하나에 대해 Kafka Connect가 보고한 런타임 상태(아래 https://kafka.apache.org/documentation/#connect_administration 참조). UNKNOWN은 Relational Migrator의 고유 값으로, Kafka Connect 워커에 액세스할 수 없는 경우와 같이 상태를 조회할 수 없을 때 사용됩니다.
  
  값은 RUNNING, PAUSED, FAILED, UNASSIGNED, RESTARTING, STOPPED 또는 UNKNOWN입니다.
  
  workerId 문자열
  
  작업이 할당된 Kafka Connect 워커(알려진 경우).
  
  트레이스 문자열
  
  작업 상태가 FAILED일 때 존재하는 실패 스택 추적.
  
  sink 객체
  
  하나의 Kafka Connect 커넥터(소스 또는 싱크)와 작업의 런타임 상태.
  
  추가 속성은 허용되지 않습니다.
  
  싱크 속성 숨기기 싱크 속성 표시 객체
  
  이름 문자열
  
  Kafka Connect에 등록된 Connector 이름입니다.
  
  상태 문자열 필수 사항
  
  커넥터 또는 작업 중 하나에 대해 Kafka Connect가 보고한 런타임 상태(아래 https://kafka.apache.org/documentation/#connect_administration 참조). UNKNOWN은 Relational Migrator의 고유 값으로, Kafka Connect 워커에 액세스할 수 없는 경우와 같이 상태를 조회할 수 없을 때 사용됩니다.
  
  값은 RUNNING, PAUSED, FAILED, UNASSIGNED, RESTARTING, STOPPED 또는 UNKNOWN입니다.
  
  작업 배열[객체]
  
  이 커넥터의 작업별 런타임 상태.
  
  작업 속성 숨기기 작업 속성 표시 객체
  
  Kafka Connect에서 보고한 단일 Kafka Connect 작업의 런타임 상태입니다.
  
  id integer 필수 사항
  
  커넥터 내의 작업 ID.
  
  상태 문자열 필수 사항
  
  커넥터 또는 작업 중 하나에 대해 Kafka Connect가 보고한 런타임 상태(아래 https://kafka.apache.org/documentation/#connect_administration 참조). UNKNOWN은 Relational Migrator의 고유 값으로, Kafka Connect 워커에 액세스할 수 없는 경우와 같이 상태를 조회할 수 없을 때 사용됩니다.
  
  값은 RUNNING, PAUSED, FAILED, UNASSIGNED, RESTARTING, STOPPED 또는 UNKNOWN입니다.
  
  workerId 문자열
  
  작업이 할당된 Kafka Connect 워커(알려진 경우).
  
  트레이스 문자열
  
  작업 상태가 FAILED일 때 존재하는 실패 스택 추적.
- failError 객체
  
  추가 속성은 허용되지 않습니다.
  
  failError 속성 숨기기 failError 속성 표시 객체
  
  errorType 문자열 필수 사항
  
  메시지 문자열 필수 사항
  
  failAt 문자열(날짜-시간) 필수 사항
  
  setupError 부울 필수 사항
  
  기본값은 false 입니다.
  
  failedLocation 문자열 | null
  
  작업이 실패하기 전의 마지막 오류 위치입니다. 전체 오류 분석은 작업 로그를 참조하십시오.
  
  failedLocationType string | null
  
  TABLE = 소스 테이블, COLLECTION = 대상 컬렉션.
  
  값은 TABLE 또는 COLLECTION입니다.
- metadata 객체
  
  추가 속성은 허용되지 않습니다.
  
  Hide metadata attributes 메타데이터 속성 표시 객체
  
  telemetryUserId 문자열
  
  검증 객체
  
  인증 속성 숨기기 인증 속성 표시 객체
  
  samplePercentage integer
  
  기본값은 100 입니다.
  
  isEmbeddedMode 부울
  
  기본값은 false 입니다.
  
  상태 문자열
  
  값은 VERIFYING, FAILED, CANCELLING, CANCELLED, VERIFIED 또는 ABORTED입니다.
- RelationalTableFilters 객체
  
  각 키가 스키마 이름을 나타내는 객체 입니다. 각 스키마 에는 테이블 필터를 적용 할 수 있는 테이블이 포함되어 있습니다.
  
  RelationalTableFilters 속성 숨기기 RelationalTableFilters 속성 표시 객체
  
  * 객체 additionalProperties
  
  각 키가 스키마 내에서 테이블 이름을 나타내는 객체 입니다.
  
  * 속성 숨기기 * 속성 표시 객체
  
  * 객체 additionalProperties
  
  추가 속성은 허용되지 않습니다.
  
  * 속성 숨기기 * 속성 표시 객체
  
  whereClause 문자열
  
  지정된 소스 테이블의 행을 필터하다 하는 SQL WHERE 절의 내용입니다.
  
  rowCount integer(int64)
  
  소스 테이블에서 반환되는 행 수를 선택적으로 제한합니다.
  
  최소값은 1입니다.
- collectionFilters 객체
  
  이 마이그레이션 에 컬렉션을 포함하거나 제외합니다.
  
  포함 전용: 지정된 포함 필터하다 와 일치하는 컬렉션만 마이그레이션됩니다.
  
  제외만: 제외 필터하다 와 일치하는 컬렉션을 제외한 모든 컬렉션이 마이그레이션됩니다.
  
  포함 및 제외: 제외 필터하다 와 일치하는 컬렉션을 제외하고 포함 필터하다 와 일치하는 컬렉션을 마이그레이션합니다.
  
  필터 없음: 모든 컬렉션이 마이그레이션됩니다.
  
  collectionFilters 속성 숨기기 collectionFilters 속성 표시 객체
  
  포함 array[string]
  
  제외 array[string]
500 application/json

내부 서버 오류
응답 속성 숨기기 응답 속성 표시 객체
- errorType 문자열 필수 사항
  
  어떤 종류의 오류가 발생했는지 식별하는 오류 카테고리입니다.
- 메시지 문자열 필수 사항
  
  무엇이 잘못되었는지에 대한 사람이 읽을 수 있는 설명입니다.
- timestamp 문자열(날짜-시간) 필수 사항
  
  오류가 발생한 날짜와 시간입니다.
- 이슈 배열[객체]
  
  이 오류를 구성하는 개별 문제입니다.
  
  At least 1 element.
  
  문제 속성 숨기기 문제 속성 표시 객체
  
  유형 문자열 필수 사항
  
  어떤 종류의 문제가 발생했는지 식별하는 오류 카테고리(SNAKE_CASE).
  
  메시지 문자열 필수 사항
  
  무엇이 잘못되었는지에 대한 사람이 읽을 수 있는 설명입니다.
  
  포인터 문자열
  
  문제의 노드에 대한 JSON 포인터(RFC 6901).

/jobs 가져오기

curl \
 --request GET 'http://127.0.0.1:8278/api/v1/jobs'

응답 예시(200)

[
  {
    "id": "string",
    "projectId": "string",
    "status": "NOT_STARTED",
    "cdcStatus": "NOT_STARTED",
    "verificationJobId": "string",
    "options": {
      "dropCollections": false,
      "mode": "SNAPSHOT",
      "truncationReportMode": "FAIL",
      "errorHandling": "FAIL",
      "errorTolerance": 42,
      "incrementalSnapshotOptions": {
        "signalingTable": "database.schema.table",
        "chunkSize": 42
      }
    },
    "jdbcConnectionString": "string",
    "mongoDbConnectionString": "string",
    "submittedAt": "2026-05-04T09:42:00Z",
    "statistics": {
      "startedAt": "2026-05-04T09:42:00Z",
      "elapsedSeconds": 42,
      "remainingTableCount": 42,
      "processingTables": [
        "string"
      ],
      "migratedTables": [
        "string"
      ],
      "totalEventsSeen": 0,
      "snapshotCompleted": false,
      "totalTableCount": 42,
      "totalEvents": 42,
      "totalEventSize": 42
    },
    "cdcStatistics": {
      "startedAt": "2026-05-04T09:42:00Z",
      "lastEventTime": "2026-05-04T09:42:00Z",
      "lastEventSourceDatabaseTime": "2026-05-04T09:42:00Z",
      "eventsInLastHour": 0,
      "eventsInLastMinute": 0,
      "totalEventsSeen": 0,
      "latestBatchMaxSourceDbLagMs": -1
    },
    "jmxConnectivity": {
      "status": "AVAILABLE",
      "lastSuccessfulScrapeAt": "2026-05-04T09:42:00Z",
      "errorMessage": "string"
    },
    "connectorStatus": {
      "source": {
        "name": "string",
        "state": "RUNNING",
        "tasks": [
          {
            "id": 42,
            "state": "RUNNING",
            "workerId": "string",
            "trace": "string"
          }
        ]
      },
      "sink": {
        "name": "string",
        "state": "RUNNING",
        "tasks": [
          {
            "id": 42,
            "state": "RUNNING",
            "workerId": "string",
            "trace": "string"
          }
        ]
      }
    },
    "failureError": {
      "errorType": "string",
      "message": "string",
      "failureAt": "2026-05-04T09:42:00Z",
      "setupError": false,
      "failedLocation": "string",
      "failedLocationType": "TABLE"
    },
    "metadata": {
      "telemetryUserId": "string",
      "verification": {
        "samplePercentage": 100,
        "isEmbeddedMode": false,
        "status": "VERIFYING"
      }
    },
    "relationalTableFilters": {
      "schema_1_name": {
        "table_1_name": {
          "whereClause": "id > 1000 AND id <= 2000"
        },
        "table_2_name": {
          "whereClause": "TRUE",
          "rowCount": 10
        }
      }
    },
    "collectionFilters": {
      "include": [
        "string"
      ],
      "exclude": [
        "string"
      ]
    }
  }
]

응답 예시(500)

{
  "errorType": "VALIDATION_ERROR",
  "message": "string",
  "timestamp": "2026-05-04T09:42:00Z",
  "issues": [
    {
      "type": "RELMIG_MAPPING_TABLE_MISSING",
      "message": "string",
      "pointer": "/project/content/mappings/0123456789abcdef0123456789abcdef/fields/Name/target/name"
    }
  ]
}