Skip to content

CreateEmptyTable

Create an empty table (metadata only) without touching storage.

Description

      description: |
        Create an empty table with the given name without touching storage.
        This is a metadata-only operation that records the table existence and sets up aspects like access control.

        For DirectoryNamespace implementation, this creates a `.lance-reserved` file in the table directory
        to mark the table's existence without creating actual Lance data files.

Request Schema

    CreateEmptyTableRequest:
      type: object
      description: |
        Request for creating an empty table.
      properties:
        id:
          type: array
          items:
            type: string
        location:
          type: string
          description: |
            Optional storage location for the table.
            If not provided, the namespace implementation should determine the table location.
        properties:
          type: object
          additionalProperties:
            type: string

Response Schema

    CreateEmptyTableResponse:
      type: object
      description: |
        Response for creating an empty table.
      properties:
        location:
          type: string
        properties:
          type: object
          additionalProperties:
            type: string
        storage_options:
          type: object
          description: |
            Configuration options to be used to access storage. The available
            options depend on the type of storage in use. These will be
            passed directly to Lance to initialize storage access.
          additionalProperties:
            type: string