Styxis
Company
Knowledge

DuckDB DESCRIBE의 alias와 실제 header를 대조한다

quoted alias를 쓰는 소비자는 DESCRIBE 이름과 실행 header의 대소문자를 그대로 대사한다. 추출 중 소문자로 정규화하면 소비자 계약을 바꾸는 schema 차이가 사라진다.

schema 생성기의 이름 계약

대소문자를 보존할 소비자는 DESCRIBE와 실제 quoted alias를 같은 기준으로 봐야 한다. 운영자가 준비한 이름 열을 Truthound Core로 대조해 잘못된 header가 계약으로 굳는 것을 막을 수 있다. [1, 2, 3]

Category와 category가 달랐던 보고

DuckDB #28300은 2.0.0 CLI에서 category AS "Category"의 실행 header는 Category인데 DESCRIBE는 category라고 보고한다. CTE 대조에서는 일치한다. 후속 수정 PR은 사용자 설치 build를 알려 주는 근거와 다르다. [1]

같은 SQL의 두 출력을 남긴다

SQL, alias 원문, DESCRIBE column_name과 실행 header를 모은다. 대소문자만 다른 alias도 포함한다. 원본 table 조회가 된다는 이유로 대소문자 민감 소비자를 소문자 schema에 묶지 않는다. [1, 3]

명시한 Category가 기준이다

설명용 category AS "Category"의 기대 이름은 Category다. Category는 통과하고 category는 보존 계약에 실패한다. 이름 일치가 값·dtype·원본 열 출처까지 확인하는 것은 아니다. [1, 3]

대소문자를 지우기 전에 검사한다

Truthound Core Python SDK 3.3.2의 ColumnPairValidator는 비결측 name 문자열을 ==로 비교한다. 추출 때부터 case를 보존해야 차이를 볼 수 있다. SDK가 DuckDB binding을 바꾸지는 않는다. [1, 2, 3]

header 직접 읽기와 CTE 대조

결과 header를 직접 읽거나 실제 배포 버전에서 CTE 경로를 검증해 schema 탐색 방법을 정한다. discovery query와 실제 query를 연결해 보존한다. [1, 3]

소비자 규칙에 맞춘 승인

겉보기 철자 차이가 다른 인터페이스에서는 열 부재가 될 수 있다. 소비자의 식별자 규칙으로 승인하되 원본 필드 정체성 검사는 별도로 둔다. [1, 3]

적용 조건

같은 SQL의 원문 alias·DESCRIBE·실행 header를 case 보존해 준비한다.

대안

실행 header 직접 읽기 또는 해당 버전의 CTE 대조를 검증한다.

한계

  • 이름 일치는 값·타입·필드 출처 전체의 일치가 아니다.

근거

사건 확인일
대상 확인일
수정일