데이터베이스 테이블
데이터베이스 테이블 모듈은 공간 내 모든 데이터베이스 테이블 자산을 한곳에서 관리하는 기능과, 공간 자원을 한곳에서 확인하고 정리하는 기능을 제공합니다.
- 자산: 데이터 개발 공간이 소유하며 전권을 가지고 관리합니다. 다른 주체(예: 공간, 프로젝트)에 권한을 부여하여 데이터 자원으로 사용하게 할 수 있습니다.
- 자원: 데이터 개발 공간이 사용할 수 있지만 소유권은 다른 주체에 있습니다.
기능 영역 개요
| 기능 영역 | 하위 기능 | 설명 |
|---|---|---|
1-기능 전환 영역 | 라이브러리/테이블 관리 | 데이터베이스 테이블 모듈의 핵심 기능으로, 공간의 다음 테이블을 확인/관리할 수 있습니다
|
직접 연결 관리 | 이 기능 영역에서 다음을 할 수 있습니다
| |
휴지통 | 라이브러리/테이블 관리에서 소프트 삭제된 공간 테이블을 회수
| |
미등록 테이블 | 라이브러리/테이블 관리에서는 공간의 개발/운영 이중 데이터베이스에 있는 테이블에 등록 상태라는 개념이 있습니다.
테이블이 미등록 상태가 될 수 있는 시나리오
| |
| 2-사전 영역 | 스토리지별 보기 |
|
| 3-탭 영역 | 탭 표시 |
|
| 4-페이지 콘텐츠 영역 | 라이브러리/테이블 관리 페이지 | 항상 열려 있는 탭으로, 데이터베이스 테이블 정보를 빠르게 검색/확인하는 기능 제공 |
| 테이블 상세 정보 페이지 | 메타데이터, 필드, DDL, 데이터 미리보기 등 데이터베이스 테이블의 상세 정보 표시 | |
| 테이블 생성/테이블 편집 페이지 | 생성 페이지에서 관리 모드와 테이블 타입을 선택한 후 해당 공간 테이블을 생성할 수 있습니다 | |
| 5-드로어 영역 | 빠른 보기 | 관리 페이지에서 바로 불러와 테이블의 핵심 정보를 제공 |
테이블과 뷰 생성
라이브러리/테이블 관리 페이지 오른쪽 상단의 +테이블을 클릭하면 새 테이블 페이지로 이동합니다.
공간 테이블 또는 뷰를 생성할 수 있습니다. 공간 테이블 생성에 대한 자세한 내용은 공간 테이블 장을 참조하십시오.
라이브러리/테이블 관리
사전 영역
라이브러리/테이블 관리의 사전 영역에는 스토리지 아래 Catalog - db - table 구조에 따라 공간에서 사용할 수 있는 모든 자산과 자원이 표시됩니다.
사전 영역은 구조에 따라 database별 테이블/뷰 수를 집계하여 표시합니다. 사전 영역에서 database 이름을 선택하면 리스트 표시 영역에 해당 database의 데이터베이스 테이블이 표시됩니다.
Tips: AE 사전 설정 스토리지에서 사용할 수 있는
- 시스템 테이블 범위는 프로젝트 권한 부여를 통해 얻어야 합니다
- 외부 공간 자원 범위는 공간 간 데이터 권한 부여를 통해 얻어야 합니다
사전 영역의 구조는 다음과 같습니다.
| 범례 | 스토리지 repo | 디렉토리 catalog | 관리 모드 | 데이터베이스 db | 설명 |
|---|---|---|---|---|---|
사전 설정 ETL 스토리지 | hive | 시스템 테이블 | ta | AE 시스템 데이터베이스, 포함: 유저 미러 테이블, 코호트 태그 테이블 등 | |
| ta_dim | AE 시스템 데이터베이스, 포함: 프로젝트 차원 테이블 | ||||
| ta_ext | AE 시스템 데이터베이스, 포함: 프로젝트 데이터 테이블 | ||||
| temp | AE 시스템 데이터베이스, 포함: 프로젝트 SQL 조회 임시 테이블 | ||||
| 공간-작업 테이블 | ws_space_${env} | 데이터 개발 플랫폼 이중 환경 데이터베이스 | |||
| 공간-IDE 테이블 | ws_space_ide | 데이터 개발 플랫폼 IDE 데이터베이스 | |||
외부 공간 권한 테이블 | ws_otherspace_product | 외부 공간이 이 공간에 권한을 부여한 운영 환경 데이터베이스 | |||
| ws_otherspace_ide | 외부 공간이 이 공간에 권한을 부여한 IDE 데이터베이스 |
리스트 표시
데이터베이스 테이블 리스트 표시 영역에서 다음을 확인할 수 있습니다.
- 데이터베이스 테이블의 네 가지 요소 스토리지 - Catalog - 데이터베이스 이름 - 테이블 이름
- 데이터베이스 테이블 관리 모드
- 데이터베이스 테이블 담당자
- 데이터베이스 테이블의 등록 상태
- 드릴다운하여 데이터베이스 테이블 상세 정보 확인
- 검색🔍: 테이블 이름과 테이블 comment로 검색 지원
필터 기능
데이터베이스 테이블 리스트 페이지에서 테이블의 주요 필드로 필터링할 수 있습니다.
- 필터 패널은 기본적으로 접혀 있으며 펼치거나 접을 수 있습니다
- 필터 항목 초기화 지원
| 필터 유형 | 필터 항목 | 열거 항목 | 설명 |
|---|---|---|---|
체크 유형 | 변경 사항 있음 | - | 공간-작업 테이블에만 해당하며, 개발 환경과 운영 환경을 비교했을 때 변경이 발생한 경우 |
| 내가 담당하는 | - | 담당자 = 현재 로그인한 유저 | |
| 곧 만료 예정 | - | 라이프사이클이 곧 만료되는 데이터베이스 테이블 | |
| 라이브 전 | - | 개발 환경에만 있고 아직 운영 환경에 배포되지 않은 데이터베이스 테이블 | |
다중 선택 유형 | 관리 모드 |
| 공간 내 테이블의 관리 모드에 따라 분류 |
테이블 타입 |
| ||
소속 주체 |
| 시스템 테이블의 주체는 프로젝트 외부 공간 권한 테이블의 주체는 다른 공간 | |
| 담당자 |
|
|
일괄 작업 기능
데이터베이스 테이블 리스트 페이지(드릴다운 상태의 리스트 페이지 포함)에서 일괄 작업을 지원합니다.
작업을 실행할 수 있는 대상 범위는 다음과 같습니다.
| 일괄 작업 기능 | 지원하는 관리 모드 | 일괄 작업을 지원하는 범위 |
|---|---|---|
| 기간 연장 | 공간-작업 테이블 | 등록 상태 = 등록됨 AND 테이블 타입 = 물리 테이블 |
| 배포 및 라이브 | 공간-작업 테이블 | 등록 상태 = 등록됨 AND (배포 상태 = 라이브 전 OR 변경 여부 = 변경 사항 있음) |
| 회수 | 공간-작업 테이블 | 등록 상태 = 등록됨(미등록 테이블은 휴지통에 넣을 수 없음)
|
드로어 영역
관리 페이지에서 테이블 카드를 클릭하면 오른쪽에 테이블 상세 정보 드로어를 바로 불러올 수 있습니다
- 현재 페이지에서 테이블의 Meta와 필드 정보를 빠르게 훑어볼 수 있어 테이블을 찾는 효율이 높아집니다
- 새 탭을 열지 않고도 불러올 수 있어 탭 수를 줄일 수 있습니다
표시 콘텐츠
| 영역 | 내용 | 표시되는 관리 모드 | 설명 |
|---|---|---|---|
| A | 환경 전환기 | 공간-작업 테이블 | 개발 환경/운영 환경 테이블 간 전환 지원 |
| B | 미등록 알림 | 공간-작업 테이블 공간-IDE 테이블 | 편집 버튼을 클릭하여 테이블 편집 페이지를 열고 저장하면 등록이 완료됩니다 |
| C | 스토리지/디렉토리/데이터베이스 정보 | 전체 | 해당 공간 테이블이 속한 schema 요소를 확인할 수 있음 |
| D | 관리 정보 | 전체 | 포함 항목
|
| E | 스토리지 방식 | 전체 |
|
| F | 담당자 | 전체 | 시스템 테이블은 기본적으로 시스템 |
| 비고 | 전체 | 없으면 - 로 표시 | |
| 라이프사이클 (일) | 공간-작업 테이블 공간-IDE 테이블 | 미등록 테이블은 - 로 표시 | |
| 라이프사이클 상태 | 전체 | 시스템 테이블 / 외부 공간 권한 테이블은 기본값이 정상이며, 미등록 테이블은 - 로 표시 | |
| G | 생성자 | 전체 | 시스템 테이블은 기본적으로 시스템 |
| 생성 시간 | 전체 | 공간 테이블의 생성 시간 | |
| 마지막 배포자 | 공간-작업 테이블 | 공간 테이블의 배포 정보 | |
| 마지막 배포 시간 | |||
| H | 필드 정보 | 전체 | 테이블 필드 정보와 필드 데이터 타입 |
| I | DDL | 전체 | 테이블 생성문(시스템 테이블은 표시하지 않음) |
직접 연결 관리
직접 연결은 AE 데이터 개발 플랫폼의 특색 있는 기능으로, 기업 내부의 데이터 체계를 AE 시스템으로 빠르게 이전할 수 있습니다.
직접 연결 기능은 주로 Trino의 Connector 기능을 활용합니다. 직접 연결 기능을 통해 AE Trino에 마운트된 커스텀 Catalog의 테이블을 기본 테이블로 삼아 워크스페이스에서 사용할 수 있는 뷰(View)를 생성할 수 있으며, 이러한 뷰를 개발 플랫폼에서는 직접 연결 뷰라고 합니다.
직접 연결 뷰는 데이터 개발 플랫폼의 공간에서 사용할 수 있고, 앱-데이터 권한 부여 기능을 통해 AE 시스템의 다른 주체(예: 분석 운영 플랫폼의 프로젝트 또는 다른 데이터 개발 공간)에 권한을 부여하여 사용하게 할 수도 있습니다.
직접 연결 기능을 사용하려면 먼저 ThinkingAI 담당자에게 연락하여 Catalog를 설정해야 합니다.
직접 연결 뷰 일괄 생성
데이터베이스 전체 데이터에 대해 직접 연결 뷰를 생성하여 기존 데이터 체계를 빠르게 도입하려면, 직접 연결 관리 페이지 오른쪽 상단의 +직접 연결 뷰를 클릭하여 일괄 생성할 수 있습니다. 생성 절차는 직접 연결 뷰 일괄 생성 장을 참조하십시오.
또한 직접 연결 뷰는 데이터 개발 플랫폼 내 뷰(view)의 특수한 유형으로, 소스 기본 테이블이 trino connector를 통해 AE 사전 설정 스토리지에 외부 마운트된 Catalog의 데이터베이스 테이블인 뷰를 말합니다.
따라서 직접 연결 뷰를 한 개만 생성하려는 경우 절차는 일반 뷰 생성과 같습니다. 자세한 절차는 공간 테이블 장을 참조하십시오.
휴지통
데이터베이스 테이블 모듈 왼쪽 도구 모음의 세 번째 아이콘을 클릭하면 공간 테이블의 휴지통 리스트로 이동합니다.
휴지통 설명:
-
회수된 운영/개발 환경 공간 테이블을 보관하며, 데이터는 유지되지만 읽거나 쓸 수 없습니다
-
지원하는 작업:
- 복구: 해당 테이블을 다시 사용합니다
- 영구 삭제: 데이터를 완전히 삭제합니다
-
기한이 지나도록 처리되지 않은 테이블(7일 넘게 보관된 테이블)은 시스템이 자동으로 정리합니다
-
일괄 복구/삭제를 지원하여 작업 효율을 높입니다
| 열 이름 | 설명 |
|---|---|
| 테이블 이름 | 공간 테이블의 테이블 이름으로, 클릭하면 휴지통에 있는 공간 테이블의 상세 정보 페이지로 이동 |
| 테이블 설명 | 유저가 직접 작성한 테이블 설명 |
| 타입 | 공간 테이블의 타입으로 테이블과 뷰 두 가지가 있으며, 필터링 가능 |
| 엔진 구성 | 해당 공간 테이블을 조회할 수 있는 쿼리 엔진으로, 여러 개일 수 있으며 필터링 가능 |
| 회수 원인 | 공간 테이블이 회수된 원인으로, 만료로 인한 회수와 수동 회수 두 가지가 있으며 필터링 가능 |
| 회수 시간 | 공간 테이블이 회수된 시간 |
| 비고 | 사용자 정의 비고 |
| 작업-복구 | 클릭하면 해당 공간 테이블이 복구되어 다시 정상적으로 접근하거나 쓸 수 있음 |
| 작업-영구 삭제 | 클릭하면 해당 공간 테이블이 영구 삭제됩니다. 영구 삭제는 취소할 수 없으므로 신중하게 작업하십시오 |
미등록 테이블
미등록 테이블의 정의
라이브러리/테이블 관리에서는 공간의 개발/운영 이중 데이터베이스에 있는 테이블에 등록 상태라는 개념이 있습니다.
- 등록됨: 공간 데이터베이스 테이블 기능 화면에서 생성한 작업 테이블
- 미등록: 엔진 측에는 존재하지만(예: IDE 모듈에서 create table로 생성) 라이브러리/테이블 관리 방식으로 생성되지 않은 테이블. 정상적으로 사용하려면 누락된 정보를 보충하여 등록을 완료해야 합니다.
미등록 테이블 관리
공간에 미등록 테이블이 있으면 데이터베이스 테이블 왼쪽 도구 모음의 네 번째 Tab 버튼이 강조 표시되고 미등록 테이블 수가 표시됩니다
- 0이면 표시하지 않음
- 9를 넘으면 9+로 표시
| 열 이름 | 설명 |
|---|---|
| 테이블 이름 | 미등록 테이블의 테이블 이름 |
| 소속 스토리지 | 사전 설정 스토리지 |
| 데이터 디렉토리 | 미등록 테이블이 속한 데이터 디렉토리 |
| 라이브러리 | ws_default_${env} 는 데이터 개발 플랫폼의 이중 환경 작업 데이터베이스 |
| 이중 환경 | 미등록 테이블은 운영 환경이나 개발 환경에만 있을 수도 있고, 두 환경에 모두 있지만 서로 다른 경우도 있습니다 따라서
|
| 연결된 작업 | 작업 플로우에서 현재 미등록 테이블을 타겟 테이블로 사용하는 작업 |
| 생성 시간 | 미등록 테이블이 생성된 시간 |
| 작업 |
|
미등록 테이블이 생기는 시나리오
다음은 데이터 개발 플랫폼 공간에서 미등록 테이블이 생길 수 있는 작업입니다
| 모듈 | 기능 영역 | 라이브러리 | 테이블/view | 처리 |
|---|---|---|---|---|
| IDE | 스크립트 | Hive.현재 공간 dev 데이터베이스 |
| 미등록 테이블로 분류 |
| Hive.현재 공간 pro 데이터베이스 |
| 미등록 테이블로 분류 | ||
| Hive.현재 공간 ide 데이터베이스 |
| 등록하지 않으며 스캔으로 식별하지 않음 | ||
| 개발 | SQL 노드 | Hive.현재 공간 dev 데이터베이스 |
| 미등록 테이블로 분류 |
등록 절차
상황 1: 테이블이 개발 환경에만 있음
개발 환경으로 등록을 선택해야 합니다
- 등록이 완료되면 기존 테이블(개발 환경)과 데이터가 유지됩니다
- 등록이 완료되면 테이블은 라이브 전 상태가 됩니다
상황 2: 테이블이 운영 환경에만 있음
- 등록이 완료되면 기존 테이블(운영 환경)과 데이터가 유지되며, 같은 구조의 테이블(개발 환경)이 하나 생성됩니다
- 등록이 완료되면 테이블은 라이브됨 상태가 됩니다
상황 3: 테이블이 개발 & 운영 환경에 모두 있음
-
유지할 테이블을 선택해야 합니다
-
선택 1: 개발 환경 유지
- 개발 환경의 테이블과 데이터를 유지하고 운영 환경의 테이블과 데이터를 삭제
- 같은 구조의 운영 환경 테이블을 하나 생성
-
선택 2: 운영 환경 유지
- 운영 환경의 테이블과 데이터를 유지하고 개발 환경의 테이블과 데이터를 삭제
- 같은 구조의 개발 환경 테이블을 하나 생성
-
등록이 완료되면 테이블은 라이브됨 상태가 됩니다