spec: add DropTable and DeregisterTable

Author: jackye1995

java/lance-namespace-adapter/src/main/java/com/lancedb/lance/namespace/adapter/ClientToServerResponse.java

@@ -14,7 +14,9 @@
 package com.lancedb.lance.namespace.adapter;
 
 import com.lancedb.lance.namespace.server.springboot.model.CreateNamespaceResponse;
+import com.lancedb.lance.namespace.server.springboot.model.DeregisterTableResponse;
 import com.lancedb.lance.namespace.server.springboot.model.DropNamespaceResponse;
+import com.lancedb.lance.namespace.server.springboot.model.DropTableResponse;
 import com.lancedb.lance.namespace.server.springboot.model.GetNamespaceResponse;
 import com.lancedb.lance.namespace.server.springboot.model.GetTableResponse;
 import com.lancedb.lance.namespace.server.springboot.model.ListNamespacesResponse;
@@ -89,4 +91,25 @@ public static TableExistsResponse tableExists(
     converted.setExists(response.getExists());
     return converted;
   }
+
+  public static DropTableResponse dropTable(
+      com.lancedb.lance.namespace.model.DropTableResponse response) {
+    DropTableResponse converted = new DropTableResponse();
+    converted.setName(response.getName());
+    converted.setNamespace(response.getNamespace());
+    converted.setLocation(response.getLocation());
+    converted.setProperties(response.getProperties());
+    converted.setTransactionId(response.getTransactionId());
+    return converted;
+  }
+
+  public static DeregisterTableResponse deregisterTable(
+      com.lancedb.lance.namespace.model.DeregisterTableResponse response) {
+    DeregisterTableResponse converted = new DeregisterTableResponse();
+    converted.setName(response.getName());
+    converted.setNamespace(response.getNamespace());
+    converted.setLocation(response.getLocation());
+    converted.setProperties(response.getProperties());
+    return converted;
+  }
 }

java/lance-namespace-adapter/src/main/java/com/lancedb/lance/namespace/adapter/ServerToClientRequest.java

@@ -14,7 +14,9 @@
 package com.lancedb.lance.namespace.adapter;
 
 import com.lancedb.lance.namespace.model.CreateNamespaceRequest;
+import com.lancedb.lance.namespace.model.DeregisterTableRequest;
 import com.lancedb.lance.namespace.model.DropNamespaceRequest;
+import com.lancedb.lance.namespace.model.DropTableRequest;
 import com.lancedb.lance.namespace.model.GetNamespaceRequest;
 import com.lancedb.lance.namespace.model.GetTableRequest;
 import com.lancedb.lance.namespace.model.ListNamespacesRequest;
@@ -86,4 +88,20 @@ public static TableExistsRequest tableExists(
     converted.setName(request.getName());
     return converted;
   }
+
+  public static DropTableRequest dropTable(
+      com.lancedb.lance.namespace.server.springboot.model.DropTableRequest request) {
+    DropTableRequest converted = new DropTableRequest();
+    converted.setName(request.getName());
+    converted.setNamespace(request.getNamespace());
+    return converted;
+  }
+
+  public static DeregisterTableRequest deregisterTable(
+      com.lancedb.lance.namespace.server.springboot.model.DeregisterTableRequest request) {
+    DeregisterTableRequest converted = new DeregisterTableRequest();
+    converted.setName(request.getName());
+    converted.setNamespace(request.getNamespace());
+    return converted;
+  }
 }

java/lance-namespace-adapter/src/main/java/com/lancedb/lance/namespace/adapter/TableController.java

@@ -15,6 +15,10 @@
 
 import com.lancedb.lance.namespace.LanceNamespace;
 import com.lancedb.lance.namespace.server.springboot.api.TableApi;
+import com.lancedb.lance.namespace.server.springboot.model.DeregisterTableRequest;
+import com.lancedb.lance.namespace.server.springboot.model.DeregisterTableResponse;
+import com.lancedb.lance.namespace.server.springboot.model.DropTableRequest;
+import com.lancedb.lance.namespace.server.springboot.model.DropTableResponse;
 import com.lancedb.lance.namespace.server.springboot.model.GetTableRequest;
 import com.lancedb.lance.namespace.server.springboot.model.GetTableResponse;
 import com.lancedb.lance.namespace.server.springboot.model.RegisterTableRequest;
@@ -55,4 +59,20 @@ public ResponseEntity<TableExistsResponse> tableExists(TableExistsRequest tableE
         ClientToServerResponse.tableExists(
             delegate.tableExists(ServerToClientRequest.tableExists(tableExistsRequest))));
   }
+
+  @Override
+  public ResponseEntity<DropTableResponse> dropTable(DropTableRequest dropTableRequest) {
+    return ResponseEntity.ok(
+        ClientToServerResponse.dropTable(
+            delegate.dropTable(ServerToClientRequest.dropTable(dropTableRequest))));
+  }
+
+  @Override
+  public ResponseEntity<DeregisterTableResponse> deregisterTable(
+      DeregisterTableRequest deregisterTableRequest) {
+    return ResponseEntity.ok(
+        ClientToServerResponse.deregisterTable(
+            delegate.deregisterTable(
+                ServerToClientRequest.deregisterTable(deregisterTableRequest))));
+  }
 }

java/lance-namespace-apache-client/.openapi-generator/FILES

@@ -3,8 +3,12 @@ README.md
 api/openapi.yaml
 docs/CreateNamespaceRequest.md
 docs/CreateNamespaceResponse.md
+docs/DeregisterTableRequest.md
+docs/DeregisterTableResponse.md
 docs/DropNamespaceRequest.md
 docs/DropNamespaceResponse.md
+docs/DropTableRequest.md
+docs/DropTableResponse.md
 docs/ErrorResponse.md
 docs/GetNamespaceRequest.md
 docs/GetNamespaceResponse.md
@@ -40,8 +44,12 @@ src/main/java/com/lancedb/lance/namespace/client/apache/auth/HttpBasicAuth.java
 src/main/java/com/lancedb/lance/namespace/client/apache/auth/HttpBearerAuth.java
 src/main/java/com/lancedb/lance/namespace/model/CreateNamespaceRequest.java
 src/main/java/com/lancedb/lance/namespace/model/CreateNamespaceResponse.java
+src/main/java/com/lancedb/lance/namespace/model/DeregisterTableRequest.java
+src/main/java/com/lancedb/lance/namespace/model/DeregisterTableResponse.java
 src/main/java/com/lancedb/lance/namespace/model/DropNamespaceRequest.java
 src/main/java/com/lancedb/lance/namespace/model/DropNamespaceResponse.java
+src/main/java/com/lancedb/lance/namespace/model/DropTableRequest.java
+src/main/java/com/lancedb/lance/namespace/model/DropTableResponse.java
 src/main/java/com/lancedb/lance/namespace/model/ErrorResponse.java
 src/main/java/com/lancedb/lance/namespace/model/GetNamespaceRequest.java
 src/main/java/com/lancedb/lance/namespace/model/GetNamespaceResponse.java

java/lance-namespace-apache-client/README.md

@@ -116,6 +116,8 @@ Class | Method | HTTP request | Description
 *NamespaceApi* | [**getNamespace**](docs/NamespaceApi.md#getNamespace) | **POST** /GetNamespace | Get information about a namespace
 *NamespaceApi* | [**listNamespaces**](docs/NamespaceApi.md#listNamespaces) | **POST** /ListNamespaces | List namespaces
 *NamespaceApi* | [**namespaceExists**](docs/NamespaceApi.md#namespaceExists) | **POST** /NamespaceExists | Check if a namespace exists
+*TableApi* | [**deregisterTable**](docs/TableApi.md#deregisterTable) | **POST** /DeregisterTable | Deregister a table from its namespace
+*TableApi* | [**dropTable**](docs/TableApi.md#dropTable) | **POST** /DropTable | Drop a table from its namespace
 *TableApi* | [**getTable**](docs/TableApi.md#getTable) | **POST** /GetTable | Get a table from the namespace
 *TableApi* | [**registerTable**](docs/TableApi.md#registerTable) | **POST** /RegisterTable | Register a table to a namespace
 *TableApi* | [**tableExists**](docs/TableApi.md#tableExists) | **POST** /TableExists | Check if a table exists
@@ -125,8 +127,12 @@ Class | Method | HTTP request | Description
 
  - [CreateNamespaceRequest](docs/CreateNamespaceRequest.md)
  - [CreateNamespaceResponse](docs/CreateNamespaceResponse.md)
+ - [DeregisterTableRequest](docs/DeregisterTableRequest.md)
+ - [DeregisterTableResponse](docs/DeregisterTableResponse.md)
  - [DropNamespaceRequest](docs/DropNamespaceRequest.md)
  - [DropNamespaceResponse](docs/DropNamespaceResponse.md)
+ - [DropTableRequest](docs/DropTableRequest.md)
+ - [DropTableResponse](docs/DropTableResponse.md)
  - [ErrorResponse](docs/ErrorResponse.md)
  - [GetNamespaceRequest](docs/GetNamespaceRequest.md)
  - [GetNamespaceResponse](docs/GetNamespaceResponse.md)

java/lance-namespace-apache-client/api/openapi.yaml

@@ -302,6 +302,70 @@ paths:
       x-content-type: application/json
       x-accepts:
       - application/json
+  /DropTable:
+    post:
+      description: |
+        Drop a table from its namespace and delete its data. If the table and its data can be immediately deleted, return information of the deleted table. Otherwise, return a transaction ID that client can use to track deletion progress.
+      operationId: DropTable
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/DropTableRequest'
+        required: true
+      responses:
+        "200":
+          $ref: '#/components/responses/DropTableResponse'
+        "400":
+          $ref: '#/components/responses/BadRequestErrorResponse'
+        "401":
+          $ref: '#/components/responses/UnauthorizedErrorResponse'
+        "403":
+          $ref: '#/components/responses/ForbiddenErrorResponse'
+        "404":
+          $ref: '#/components/responses/NotFoundErrorResponse'
+        "503":
+          $ref: '#/components/responses/ServiceUnavailableErrorResponse'
+        "5XX":
+          $ref: '#/components/responses/ServerErrorResponse'
+      summary: Drop a table from its namespace
+      tags:
+      - Table
+      x-content-type: application/json
+      x-accepts:
+      - application/json
+  /DeregisterTable:
+    post:
+      description: |
+        Deregister a table from its namespace. The table content remains available in the storage.
+      operationId: DeregisterTable
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/DeregisterTableRequest'
+        required: true
+      responses:
+        "200":
+          $ref: '#/components/responses/DeregisterTableResponse'
+        "400":
+          $ref: '#/components/responses/BadRequestErrorResponse'
+        "401":
+          $ref: '#/components/responses/UnauthorizedErrorResponse'
+        "403":
+          $ref: '#/components/responses/ForbiddenErrorResponse'
+        "404":
+          $ref: '#/components/responses/NotFoundErrorResponse'
+        "503":
+          $ref: '#/components/responses/ServiceUnavailableErrorResponse'
+        "5XX":
+          $ref: '#/components/responses/ServerErrorResponse'
+      summary: Deregister a table from its namespace
+      tags:
+      - Table
+      x-content-type: application/json
+      x-accepts:
+      - application/json
 components:
   examples:
     ListNamespacesEmptyExample:
@@ -369,6 +433,18 @@ components:
           schema:
             $ref: '#/components/schemas/TableExistsResponse'
       description: Result of checking if a table exists
+    DropTableResponse:
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/DropTableResponse'
+      description: Response of DropTable
+    DeregisterTableResponse:
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/DeregisterTableResponse'
+      description: Response of DeregisterTable
     BadRequestErrorResponse:
       content:
         application/json:
@@ -829,4 +905,79 @@ components:
           type: boolean
       required:
       - exists
+    DropTableRequest:
+      example:
+        name: name
+        namespace:
+        - namespace
+        - namespace
+      properties:
+        name:
+          type: string
+        namespace:
+          items:
+            type: string
+          type: array
+      required:
+      - name
+    DropTableResponse:
+      example:
+        name: name
+        namespace:
+        - namespace
+        - namespace
+        location: location
+        properties:
+          key: properties
+        transactionId: transactionId
+      properties:
+        name:
+          type: string
+        namespace:
+          items:
+            type: string
+          type: array
+        location:
+          type: string
+        properties:
+          additionalProperties:
+            type: string
+        transactionId:
+          type: string
+    DeregisterTableRequest:
+      example:
+        name: name
+        namespace:
+        - namespace
+        - namespace
+      properties:
+        name:
+          type: string
+        namespace:
+          items:
+            type: string
+          type: array
+      required:
+      - name
+    DeregisterTableResponse:
+      example:
+        name: name
+        namespace:
+        - namespace
+        - namespace
+        location: location
+        properties:
+          key: properties
+      properties:
+        name:
+          type: string
+        namespace:
+          items:
+            type: string
+          type: array
+        location:
+          type: string
+        properties:
+          additionalProperties:
+            type: string
 

java/lance-namespace-apache-client/docs/DeregisterTableRequest.md

@@ -0,0 +1,14 @@
+
+
+# DeregisterTableRequest
+
+
+## Properties
+
+| Name | Type | Description | Notes |
+|------------ | ------------- | ------------- | -------------|
+|**name** | **String** |  |  |
+|**namespace** | **List<String>** |  |  [optional] |
+
+
+

java/lance-namespace-apache-client/docs/DeregisterTableResponse.md

@@ -0,0 +1,16 @@
+
+
+# DeregisterTableResponse
+
+
+## Properties
+
+| Name | Type | Description | Notes |
+|------------ | ------------- | ------------- | -------------|
+|**name** | **String** |  |  [optional] |
+|**namespace** | **List<String>** |  |  [optional] |
+|**location** | **String** |  |  [optional] |
+|**properties** | **Map<String, String>** |  |  [optional] |
+
+
+

java/lance-namespace-apache-client/docs/DropTableRequest.md

@@ -0,0 +1,14 @@
+
+
+# DropTableRequest
+
+
+## Properties
+
+| Name | Type | Description | Notes |
+|------------ | ------------- | ------------- | -------------|
+|**name** | **String** |  |  |
+|**namespace** | **List<String>** |  |  [optional] |
+
+
+

java/lance-namespace-apache-client/docs/DropTableResponse.md

@@ -0,0 +1,17 @@
+
+
+# DropTableResponse
+
+
+## Properties
+
+| Name | Type | Description | Notes |
+|------------ | ------------- | ------------- | -------------|
+|**name** | **String** |  |  [optional] |
+|**namespace** | **List<String>** |  |  [optional] |
+|**location** | **String** |  |  [optional] |
+|**properties** | **Map<String, String>** |  |  [optional] |
+|**transactionId** | **String** |  |  [optional] |
+
+
+