ListDatabaseTables 2025.5.31.15

번들

org.apache.nifi | nifi-standard-nar

설명

데이터베이스 연결에서 테이블에 대한 메타데이터에 해당하는 특성을 각각 포함하는 플로우 파일 세트를 생성합니다. 테이블 메타데이터를 한 번 가져오면 새로 고침 간격(설정된 경우)이 경과하거나 상태가 수동으로 지워질 때까지 다시 가져오지 않습니다.

태그

database, jdbc, list, sql, table

입력 요구 사항

FORBIDDEN

민감한 동적 속성 지원

false

속성

속성

설명

list-db-include-count

테이블의 행 수를 플로우 파일 특성으로 포함할지 여부입니다. 검색된 목록의 각 테이블에 대해 데이터베이스 쿼리가 생성되므로 성능에 영향을 미칩니다.

list-db-refresh-interval

프로세서 상태를 재설정하기 전까지 경과할 시간으로, 현재 모든 테이블이 목록에 표시됩니다. 이 간격 동안 프로세서는 계속 실행될 수 있지만 이미 목록에 있는 테이블은 다시 나열되지 않습니다. 그러나 프로세서가 실행되면 새/추가된 테이블이 목록에 표시됩니다. 값이 0이면 상태가 자동으로 초기화되지 않으므로 사용자가 수동으로 상태를 지워야 합니다.

list-db-tables-catalog

데이터베이스 테이블을 나열할 카탈로그의 이름입니다. 이름은 데이터베이스에 저장된 카탈로그 이름과 일치해야 합니다. 속성이 설정되어 있지 않으면 카탈로그 이름이 테이블 검색 범위를 좁히는 데 사용되지 않습니다. 속성이 빈 문자열로 설정된 경우 카탈로그가 없는 테이블이 목록에 표시됩니다.

list-db-tables-db-connection

데이터베이스에 대한 연결을 얻는 데 사용되는 컨트롤러 서비스

list-db-tables-name-pattern

데이터베이스에서 테이블을 일치시키기 위한 패턴입니다. 패턴 내에서 “%”는 0개 이상의 문자로 이루어진 하위 문자열을 일치시키는 것을 의미하며, “_”는 1개의 문자를 일치시키는 것을 의미합니다. 패턴은 데이터베이스에 저장된 테이블 이름과 일치해야 합니다. 속성이 설정되어 있지 않으면 모든 테이블이 검색됩니다.

list-db-tables-schema-pattern

데이터베이스에서 스키마를 일치시키기 위한 패턴입니다. 패턴 내에서 “%”는 0개 이상의 문자로 이루어진 하위 문자열을 일치시키는 것을 의미하며, “_”는 1개의 문자를 일치시키는 것을 의미합니다. 패턴은 데이터베이스에 저장된 스키마 이름과 일치해야 합니다. 속성이 설정되어 있지 않으면 스키마 이름이 테이블 검색 범위를 좁히는 데 사용되지 않습니다. 속성이 빈 문자열로 설정된 경우 스키마가 없는 테이블이 목록에 표시됩니다.

list-db-tables-types

포함할 테이블 유형을 쉼표로 구분한 목록입니다. 예를 들어, 일부 데이터베이스는 TABLE 및 VIEW 유형을 지원합니다. 속성이 설정되어 있지 않으면 모든 유형의 테이블이 반환됩니다.

record-writer

목록 작성에 사용할 Record Writer를 지정합니다. 지정하지 않으면 목록에 있는 각 엔터티에 대해 FlowFile 이 1개씩 생성됩니다. Record Writer를 지정하면 모든 엔터티는 개별 FlowFiles 에 특성을 추가하는 대신 단일 FlowFile 에 기록됩니다.

상태 관리

범위

설명

CLUSTER

테이블 목록을 수행한 후 쿼리의 타임스탬프가 저장됩니다. 이렇게 하면 프로세서가 다음에 프로세서를 실행할 때 테이블 목록을 다시 나열하지 않습니다. 프로세서 속성에서 새로 고침 간격을 지정하면 프로세서가 이 간격이 경과했음을 감지하면 상태가 초기화되고 그 결과 테이블이 다시 목록에 표시됩니다. 이 프로세서는 기본 노드에서만 실행되도록 되어 있습니다.

관계

이름

설명

성공

수신된 모든 FlowFiles 은 성공으로 라우팅됩니다

Writes 특성

이름

설명

db.table.name

연결에서 데이터베이스 테이블의 이름을 포함합니다

db.table.catalog

테이블이 속한 카탈로그의 이름을 포함합니다(null일 수 있음)

db.table.schema

테이블이 속한 스키마의 이름을 포함합니다(null일 수 있음)

db.table.fullname

완전히 정규화된 테이블 이름(카탈로그, 스키마 등)을 포함합니다

db.table.type

연결에서 데이터베이스 테이블의 유형을 포함합니다. 일반적인 유형은 “TABLE”, “VIEW”, “SYSTEM TABLE”, “GLOBAL TEMPORARY”, “LOCAL TEMPORARY”, “ALIAS”, “SYNONYM” 입니다

db.table.remarks

연결에서 데이터베이스 테이블의 이름을 포함합니다

db.table.count

테이블의 행 수를 포함합니다

다른 구성 요소가 포함된 사용 사례

데이터베이스 전체 로딩을 수행하여 모든 테이블 또는 특정 테이블 세트에서 모든 행을 검색합니다.