Create and manage catalogs

Catalogs are the top-level resources in Data Catalog. This guide walks through catalog management.

Create catalog

To use Data Catalog, create a catalog first.

1. Go to the KakaoCloud console > Analytics > Data Catalog.

2. In the Catalog menu, click Create catalog.

3. In the Create catalog pop-up window, enter the required information and click Create.

   Field	Description
   Type	Select catalog type. - Standard catalog: Compatible with Apache Hive Metastore - Iceberg catalog: Dedicated to the Apache Iceberg table format (⚠️ only one can be created per project)
   Name	Catalog name
   VPC settings	Network where the catalog belongs (⚠️ required only for Standard type)

info

• Only one Standard catalog can be created per subnet.
• Only one Iceberg catalog can be created per project.

💡 Catalogs have various status values from creation to termination. Creation may take about 10 minutes.

View catalog list

You can view status and basic information for created catalogs on the list page.

1. Go to the KakaoCloud console > Analytics > Data Catalog.

2. In the Catalog menu, check the catalog list.

   Field	Description
   Name	Name of the catalog specified by the user
   Status	Current status of the catalog - Catalogs in the Terminated state are not displayed in the list. - For detailed descriptions of each state, see Resource status and lifecycle.
   Type	Catalog type - Standard or Iceberg
   VPC/Subnet	VPC and subnet where the catalog was created - ⚠️ Applicable only to the Standard catalog type
   Created at	Timestamp when the catalog was created
   Created by	User who created the catalog
   [⋮] button	Delete catalog

View catalog details

You can view detailed catalog information.

1. Go to the KakaoCloud console > Analytics > Data Catalog.

2. In the Catalog menu, select the catalog to view.

3. Check the catalog details.

   Summary

   Field	Description
   Status	Current catalog status
   Type	Catalog type
   ID	Catalog UUID
   URL	URL that can be used to reference the catalog - Standard catalog: Provided through Apache Thrift protocol - Iceberg catalog: Provided as an Iceberg REST endpoint over HTTPS
   VPC/Subnet	VPC and subnet where the catalog was created (⚠️ displayed only for Standard type)

   
   

   Details

   You can view, create, and manage databases that belong to the catalog.

   Database list

   Category	Description
   Name	User-specified database name
   Status	Database status
   Type	Database type
   Path	Path where the database is located
   Created at	Date and time when the database was created
   Created by	User who created the database

Delete catalog

You can delete catalogs that are no longer in use.

caution

When you delete a catalog, related resources are permanently released and cannot be recovered. Child databases and tables are also deleted and cannot be recovered.

1. Go to the KakaoCloud console > Analytics > Data Catalog.
2. In the Catalog menu, click the [⋮] button for the catalog to delete and select Delete.
3. In the pop-up window, review the catalog to delete, enter the catalog name, and click Delete.