Tổng quan

Tài liệu hướng dẫn tạo và quản lý Connection kiểu Apache Iceberg — kết nối bảo mật lưu thông tin xác thực tới một Iceberg REST Catalog bên ngoài, dùng làm nguồn cho Catalog kiểu Relational. Trước khi thực hiện các bước dưới đây, cần đảm bảo đã hoàn tất phần thiết lập nền tảng tại Data setup > Overview (Metastore, Metalake ở trạng thái Active).

Danh Sách Connection (List View)

• Các bước thực hiện:

1. Từ menu điều hướng, vào Catalogs > Location Connection > Connections.
2. Tại màn hình danh sách, chọn Tab "Connections" (Tab "External Locations" nằm cạnh bên dùng cho vùng lưu trữ ngoài).
3. Sử dụng ô Search name trong khu vực Filters để tìm kiếm nhanh theo tên.
4. Bảng danh sách hiển thị các cột:
   • Name: Tên định danh của Connection.
   • URL: Iceberg URI đã khai báo (ví dụ http://101.99.57.94:19121/iceberg).
   • Type: Loại kết nối (apache_iceberg).
   • Status: Tình trạng kết nối tới nguồn tại thời điểm kiểm tra gần nhất:

     Giá trị	Ý nghĩa
     Healthy	Kết nối tới Iceberg REST Catalog bình thường.
     Unhealthy	Không thể kết nối (sai URI/Token, external location không hợp lệ, mạng chặn...).

   • Created date: Thời điểm tạo Connection.
   • Action: Nút "..." để thao tác nhanh. Hiện tại chỉ hỗ trợ "Edit" (xem Mục 4).
5. Nhấn nút "+ Create connection" ở góc trên bên phải để khởi tạo mới.

Tạo Mới Connection (Create)

Việc tạo Connection được thực hiện qua 3 bước tuần tự: Connection basics, Authentication, Catalog basics.

Bước 1 - Connection basics

• Connection Name:* Tên định danh duy nhất cho Connection.
• Connection Type:* Chọn "Apache Iceberg" trong danh sách (Apache Iceberg, PostgreSQL, ClickHouse).
• Description: (Tùy chọn) Ghi chú mục đích sử dụng của Connection.

Nhấn "Next" để sang bước Authentication.

Bước 2 - Authentication (Apache Iceberg)

• Iceberg URI:* Địa chỉ endpoint của Iceberg REST Catalog (ví dụ: https://...).
• Token: (Tùy chọn) Mã xác thực truy cập Iceberg REST Catalog nếu có yêu cầu. Có thể bấm biểu tượng 👁 để hiện/ẩn giá trị đã nhập.
• Select external location:* Chọn một External Location đã khởi tạo trước đó (xem Location - S3) để làm nơi lưu trữ vật lý cho dữ liệu Iceberg. Location này là bắt buộc, tương ứng với location của iceberg rest tham chiếu đến — hệ thống báo lỗi "External location is required." nếu bỏ trống.
  • Ví dụ: cấu hình external iceberg rest (cụ thể là nessie) nessie.catalog.warehouses.warehouse-name.location=s3://bucket-name/subpath. thì External Location tương ứng trên hệ thống phải có quyền đọc (ghi nếu cầu) trên bucket/subpath tương ứng
• Sub path: (Tùy chọn) Thư mục con bên trong External Location để giới hạn phạm vi lưu trữ (ví dụ: sub/path).
• Nếu chưa có External Location phù hợp, nhấn "+ Create a new external location" để tạo nhanh mà không cần rời khỏi luồng tạo Connection.

Nhấn "Next" để sang bước Catalog basics, hoặc "Back" để quay lại bước trước.

Bước 3 - Catalog basics

• Catalog Name:* Tên Catalog sẽ được tạo gắn với Connection này. Bắt buộc nhập, tối thiểu 6 ký tự (hệ thống báo lỗi "Catalog name is required and must be at least 6 characters long." nếu không hợp lệ).

Nhấn "Create" để hoàn tất khởi tạo Connection và Catalog tương ứng.

Xem Chi Tiết (View Detail)

🚧 Coming soon — Chức năng xem chi tiết Connection hiện chưa khả dụng trên giao diện, sẽ được bổ sung ở bản cập nhật tiếp theo.

Chỉnh Sửa (Edit)

1. Từ danh sách, nhấn "..." > "Edit" trên dòng Connection cần sửa.
2. Các trường sau không thể chỉnh sửa (hiển thị mờ/khóa): Connection Name, Connection Type.
3. Các trường có thể cập nhật:
   • Description
   • Iceberg URI, Token, Select external location, Sub path
4. Nhấn "Save" để lưu thay đổi, hoặc "Cancel" để hủy bỏ.

Xóa (Delete)

🚧 Coming soon — Chức năng xóa Connection hiện chưa khả dụng trên giao diện (menu Action hiện chỉ có "Edit"), sẽ được bổ sung ở bản cập nhật tiếp theo. Trong thời gian chờ, liên hệ Quản trị viên hệ thống để hỗ trợ gỡ bỏ Connection không còn sử dụng.