[Subtask] Add Table APIs in Gravitino Python client

[xunliu]

Describe the subtask

Add these Python function interfaces into Gravitino Python client, reference to the document for the API descriptions.

listTables(...): https://datastrato.ai/docs/0.4.0/api/rest/list-tables loadTable(...): https://datastrato.ai/docs/0.4.0/api/rest/load-table createTable(...): https://datastrato.ai/docs/0.4.0/api/rest/create-table alterTable(...): https://datastrato.ai/docs/0.4.0/api/rest/alter-table dropTable(...): https://datastrato.ai/docs/0.4.0/api/rest/drop-table

We can reference the Gravitino JAVA client implementation, RelationalCatalog.java

Parent issue

2113

[Lanznx]

@xunliu I'm interesting in this issue, can I take this?

[xunliu]

hi @Lanznx Thank you for your interest in this issue, I assigned to you.

[Lanznx]

After reviewing the java client and current python client, below is the planned structure and purpose of each file. Could someone please review these and provide feedback? If that's ok, I will begin implementing the task.

• tests/
  • integration/
    • test_relational_catalog.py
• gravitino/
  • api/
    • relational_catalog.py
      • implements table_catalog
      • extends base_schema_catalog
    • table.py
      • An interface representing a table
    • table_catalog.py
      • An interface defines the public API for managing tables in a schema
    • table_change.py
      • An interface defines the public API for updating tables in a schema
  • dto/
    • requests/
      • table_create_request.py
      • table_update_request.py
      • table_updates_request.py
    • responses/
      • table_list_response.py
      • table_response.py
    • table_dto.py

[Lanznx]

After discussion with Tim Wang, I found that there are some things missing (columns, indexes, sort_orders, ...) Current plan will be implement the required elements first. (ref: https://datastrato.ai/docs/0.5.1/api/rest/create-table) To keep the task as small as possible, I will only provide interfaces for those optional elements in the first PR.

So here's the updated Full Version planned structure (but in the first PR will only provide required part) :

• tests/
  • integration/
    • test_relational_catalog.py
• gravitino/
  • api/
    • rel/
      • expressions/
        • transforms/
          • transform.py
          • transforms.py
        • distributions/
          • distribution.py
          • distributions.py
        • literals/
          • literal.py
          • literals.py
        • sorts/
          • sort_order.py
          • sort_orders.py
        • transforms/
          • transform.py
          • transforms.py
        • expression.py
      • indexes/
        • index.py
        • indexes.py
      • column.py
      • table_catalog.py
    • table.py
    • table_change.py
  • catalog/
    • relational_catalog.py
      • implements table_catalog
      • extends base_schema_catalog
  • dto/
    • requests/
      • table_create_request.py
      • table_update_request.py
      • table_updates_request.py
    • responses/
      • table_list_response.py
      • table_response.py
    • table_dto.py