edonaire
Contributor

If you already have the credentials file with a bearer token, you're pretty much there! 😛

On Free Edition you can't register the share in Unity Catalog, but you can still access the data using the Delta Sharing protocol directly. Two ways to do it:

1. Python (easiest for exploration)

Install the client:

 
pip install delta-sharing

Then point it at your credentials file (.json or .share):

 
python
import delta_sharing
profile_file = "/path/to/your/credentials.file"

# List available tables
client = delta_sharing.SharingClient(profile_file)
print(client.list_all_tables())

# Load a table into pandas
df = delta_sharing.load_as_pandas(
    profile_file + "#share.schema.table"
)
df.head()

2. Spark (if your environment supports it)

 
python
spark.read.format("deltaSharing") \    .load("/path/to/credentials.file#share.schema.table") \    .show()

 

A few Free Edition limitations worth knowing:

  • No Unity Catalog integration — you can't register the share as a catalog
  • No persistent metadata layer for the shared data
  • Access is session-based, straight from the credentials file

So the workflow is more "connect and read" than "govern and catalog."


Full docs covering both Python and Spark usage: https://docs.delta.io/latest/delta-sharing.html

If you let me know which environment you're on (local Python, Databricks Free, etc.), I can tailor the example a bit more.