Skip to content

Reading Lance Datasets

read_lance

read_lance(
    uri=None, 
    *, 
    namespace=None, 
    table_id=None, 
    columns=None, 
    filter=None, 
    storage_options=None, 
    **kwargs)

Read a Lance dataset and return a Ray Dataset.

Parameters:

  • uri: The URI of the Lance dataset to read from (either uri OR namespace+table_id required)
  • namespace: LanceNamespace instance for metadata catalog integration (requires table_id)
  • table_id: Table identifier as list of strings (requires namespace)
  • columns: Optional list of column names to read
  • filter: Optional filter expression to apply
  • storage_options: Optional storage configuration dictionary
  • base_store_params: Optional runtime storage options keyed by registered base path URI, used for BlobV2 references outside the dataset root
  • scanner_options: Optional scanner configuration dictionary
  • ray_remote_args: Optional kwargs for Ray remote tasks
  • concurrency: Optional maximum number of concurrent Ray tasks
  • override_num_blocks: Optional override for number of output blocks

Returns: Ray Dataset