Creating a catalog

Create an Iceberg REST Catalog catalog within your project namespace. The Iceberg REST Catalog and Object Storage components must be enabled in the cluster.

A bucket for the catalog data and its access key are provisioned automatically. You do not need to create them beforehand.

Using the CLIUsing the CLI

1. Create a file named stacklandrestcatalog.yaml with the StacklandRestCatalog resource configuration:

   apiVersion: stacklandrestcatalog.stackland.yandex.cloud/v1alpha1
   kind: StacklandRestCatalog
   metadata:
     name: analytics
   spec:
     description: Analytics Iceberg catalog
     labels:
       environment: test
     deletionProtection: false
   

   Specify the catalog name in metadata.name. You can also add an optional description in spec.description, set labels in spec.labels, or enable deletion protection with spec.deletionProtection: true. Labels are set only when a catalog is created.

2. Apply the manifest:

   kubectl apply -f stacklandrestcatalog.yaml -n <namespace>
   

3. Check the catalog status:

   kubectl get stacklandrestcatalog analytics -n <namespace>
   

   Wait for the ready status in the Phase column.

Using the management consoleUsing the management console

1. Open the project and select the namespace you want to create the catalog in.

2. In the left-hand menu, select REST Catalog → Catalogs.

3. Click Create catalog.

4. Under Main parameters, fill in the following fields:

   • Name: Catalog name that is unique within the namespace. Use up to 63 characters: lowercase Latin letters, digits, and hyphens. The name must start with a letter and end with a letter or digit.
   • Description: Description up to 256 characters long. This is an optional field.
   • Labels: Key-Value pairs. To add a pair, click Add label. The keys must be unique. Labels cannot be modified after the catalog is created.
   • Deletion protection: Enable this option to prevent accidental deletion of the catalog and its data.

5. Click Create and wait for the catalog to appear as ready in the list.

After creating it, assign permissions to users, groups, or service accounts. To query data via Trino, connect the catalog to a cluster within the same namespace.