---
title: 카탈로그 API
description: 레이크 스키마와 테이블 목록을 조회하고 열 순서, 타입, null 허용 여부, 정규화된 이름을 확인합니다.
species: reference
---
# 카탈로그 API

카탈로그 API는 이 자격 증명으로 쿼리할 수 있는 테이블을 제공합니다. 숨겨진 이름이 다른 조직에 존재하는지는 공개하지 않습니다.

## 스키마 목록 조회

```endpoint
GET /catalog
```

접근 가능한 스키마 리소스를 반환합니다. 이름은 `titan.<schema>.<table>`의 가운데 부분과 일치합니다.

## 테이블 목록 조회

```endpoint
GET /catalog/{schema}
```

스키마 하나의 테이블과 논리 뷰를 반환합니다. 스키마를 하나의 경로 구간으로 URL 인코딩하세요.

## 테이블 정보 조회

```endpoint
GET /catalog/{schema}/{table}
```

정규화된 이름과 순서대로 나열된 열의 데이터 타입, null 허용 여부를 반환합니다. 화면 표시용 레이블을 긁어오는 대신 이 응답으로 쿼리를 구성하세요.

```json
{
  "object": "table",
  "schema": "stripe",
  "name": "charges",
  "qualified_name": "titan.stripe.charges",
  "columns": [
    { "name": "id", "type": "string", "nullable": false },
    { "name": "amount", "type": "integer", "nullable": true }
  ]
}
```

이름이 없거나 권한이 없으면 모두 `404 catalog_not_found`를 반환합니다. 카탈로그 읽기에는 현재 API 전환 단계에서 허용하는 데이터 또는 쿼리 읽기 권한 범위가 필요합니다.

응답은 요청 시점의 카탈로그 뷰 하나를 반영합니다. 메타데이터를 가져온 뒤 소스가 열을 발견하면 엄격한 열 선택 구문을 생성하기 전에 테이블을 다시 조회하세요.