기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 시스템 카탈로그 쿼리
<a name="working.catalog"></a>

**중요**  
지원 종료 알림: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 [Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)을 참조하세요.

Amazon QLDB 원장에 생성하는 각 테이블에는 시스템에서 할당한 고유 ID가 있습니다. 시스템 카탈로그 테이블 `information_schema.user_tables`을 쿼리하여 테이블 ID, 인덱스 목록 및 기타 메타데이터를 찾을 수 있습니다.

시스템에서 할당한 모든 ID는 Base62로 인코딩된 문자열로 각각 표시되는 범용 고유 식별자(UUID)입니다. 자세한 내용은 [Amazon QLDB의 고유 ID](working.unique-id.md)을 참조하세요.

다음 예제는 `VehicleRegistration` 테이블의 메타데이터 속성을 반환하는 쿼리 결과를 보여줍니다.

```
SELECT * FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'
```

```
{
    tableId: "5PLf9SXwndd63lPaSIa0O6",
    name: "VehicleRegistration",
    indexes: [
        { indexId: "Djg2nt0yIs2GY0T29Kud1z", expr: "[VIN]", status: "ONLINE" },
        { indexId: "4tPW3fUhaVhDinRgKRLhGU", expr: "[LicensePlateNumber]", status: "BUILDING" }
    ],
    status: "ACTIVE"
}
```

**테이블 메타데이터 필드**
+ `tableId` - 테이블의 고유 ID입니다.
+ `name` - 테이블 이름입니다.
+ `indexes` - 테이블의 인덱스 목록입니다.
  + `indexId` - 인덱스의 고유 ID입니다.
  + `expr` - 인덱싱된 문서 경로입니다. 이 필드는 `[fieldName]` 형식의 문자열입니다.
  + `status` - 인덱스의 현재 상태(`BUILDING`, `FINALIZING`, `ONLINE`, `FAILED`, 또는`DELETING`)입니다. QLDB는 상태가 `ONLINE`이면 쿼리에 인덱스를 사용하지 않습니다.
  + `message` - 인덱스에 `FAILED` 상태가 있는 이유를 설명하는 오류 메시지입니다. 이 필드는 실패한 인덱스에만 포함됩니다.
+ `status` - 테이블의 현재 상태(`ACTIVE` 또는`INACTIVE`)입니다. 테이블을 `DROP` 할 경우 `INACTIVE`이 됩니다.

`DROP TABLE` 및 `UNDROP TABLE` 문을 사용하여 테이블을 관리하는 방법을 알아보려면 [테이블 관리](working.manage-tables.md)으로 이동하세요.