topic Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame in Data Engineering

pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

ckarrasexo — Wed, 29 May 2024 20:06:08 GMT

I noticed that on some Databricks 14.3 clusters, I get DataFrames with type pyspark.sql.connect.dataframe.DataFrame, while on other clusters also with Databricks 14.3, the exact same code gets DataFrames of type pyspark.sql.DataFrame

pyspark.sql.connect.dataframe.DataFrame seems to be causing various issues.

for example:

Code that checks for isinstance(df, DataFrame) does not recognize df to be a DataFrame, even though pyspark.sql.connect.dataframe.DataFrame inherits from pyspark.sql.DataFrame
I get this error with pyspark.sql.connect.dataframe.DataFrame and a third-party library (Great Expectations), but not with pyspark.sql.connect.DataFrame [CANNOT_RESOLVE_DATAFRAME_COLUMN] Cannot resolve dataframe column "<column name>". It's probably because of illegal references like `df1.select(df2.col("a"))`. SQLSTATE: 42704

To help investigate, I would like to know:

What is the difference between pyspark.sql.connect.dataframe.DataFrame and pyspark.sql.DataFrame?
What determines if I will get one type of DataFrame or the other?
Does pyspark.sql.connect.dataframe.DataFrame have limitations that would lead the issues I have to be expected?

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

ckarrasexo — Fri, 31 May 2024 14:13:41 GMT

Hi @Retired_mod,

That's incorrect. I use exactly the same code and either get a pyspark.sql.dataframe.DataFrame, or pyspark.sql.connect.dataframe.DataFrame depending on the cluster. It doesn't matter if I create the dataframe using spark.read.table, spark.sql, or even spark.createDataFrame for in-memory data, what changes the class I will get is the cluster configuration.

This screenshot illustrates what I mean. I ran the same notebook on two different clusters and will get a different DataFrame type depending on the cluster. The only difference I can see between the two clusters is that one is a single-user cluster, and the other one is a shared (multi-user) cluster. Both clusters use Databricks 14.3.

So the choice for the class to use is an internal implementation decision by Databricks, and the question is what leads Databricks to pick one or another class, and, considering that they don't appear to be 100% interchangeable, what are the limitations?

Also note that both classes have methods like select, filter, groupBy, cache, persist that can be used the same way with both classes. Both can also be used to run SQL queries or directly read a table without using a query.

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

mchugani — Wed, 07 Aug 2024 06:35:53 GMT

@Retired_mod @ckarrasexo Any updates on this? I'm facing the same issue

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

JSherrill — Tue, 27 Aug 2024 22:37:25 GMT

@Retired_mod I am also running into this issue, also with Great Expectations as it happens. I have also tried using the read paquert like you suggested and am still getting the problematic format. Is it possible to direct Databricks to create one type, or convert or cast between them?

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

JSherrill — Tue, 27 Aug 2024 22:59:37 GMT

Additional info. In Databricks 13.3, the spark variable we're provided is of type pyspark.sql.SparkSession. In 15.4 it is created as pyspark.sql.connect.session.SparkSession (both shared clusters; it may behave differently for single node configuration).

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

filipniziol — Wed, 28 Aug 2024 19:54:21 GMT

What makes the difference is whether the cluster is using Spark Connect or not.
Shared clusters are using Spark Connect, so even the spark session is of different type:

To compare on single user cluster:

What I tested is that you can disable Spark Connect on the cluster by setting spark.databricks.service.server.enabled to false, but in this case everything stops working:

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

Chris78 — Tue, 17 Sep 2024 08:37:02 GMT

Hitting the same problems trying to check the type of variables to pick out DataFrames.

Ended up getting around this (temporarily at least) by importing the following instead:

from pyspark.sql.connect.dataframe import DataFrame

both 'isinstance(df, DataFrame)' then works again for my dataframe variables that are of type 'pyspark.sql.connect.dataframe.DataFrame'

(if you have already imported from 'from pyspark.sql import DataFrame' you probably need to 'del DataFrame' then redo the import above).

Note that this does however produce a console message as follows, so ymmv:
sc will be removed in future DBR versions

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

Ariusuke — Tue, 08 Oct 2024 10:10:23 GMT

@ckarrasexo wrote:
I noticed that on some Databricks 14.3 clusters, I get DataFrames with type pyspark.sql.connect.dataframe.DataFrame, while on other clusters also with Databricks 14.3, the exact same code gets DataFrames of type pyspark.sql.DataFrame
pyspark.sql.connect.dataframe.DataFrame seems to be causing various issues.
for example:
Code that checks for isinstance(df, DataFrame) does not recognize df to be a DataFrame, even though pyspark.sql.connect.dataframe.DataFrame inherits from pyspark.sql.DataFrame
I get this error with pyspark.sql.connect.dataframe.DataFrame and a third-party library (Great Expectations), but not with pyspark.sql.connect.DataFrame [CANNOT_RESOLVE_DATAFRAME_COLUMN] Cannot resolve dataframe column "<column name>". It's probably because of illegal references like `df1.select(df2.col("a"))`. SQLSTATE: 42704
To help investigate, I would like to know:
What is the difference between pyspark.sql.connect.dataframe.DataFrame and pyspark.sql.DataFrame?
What determines if I will get one type of DataFrame or the other?
Does pyspark.sql.connect.dataframe.DataFrame have limitations that would lead the issues I have to be expected?

Inconsistencies in my Databricks 14.3 where some clusters return DataFrames as pyspark.sql.connect.dataframe.DataFrame, while others return pyspark.sql.DataFrame. This affects type checking with isinstance(df, DataFrame), and I'm facing errors with Great Expectations, specifically "CANNOT_RESOLVE_DATAFRAME_COLUMN." Has anyone else dealt with this issue, and what solutions did you find?

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

kenmyers-8451 — Tue, 19 Aug 2025 23:50:04 GMT

+1 encountered this for the first time today over a year later from when it was first posted. I've had a piece of code that was checking if dataframes were an instance of DataFrame from spark.sql.DataFrame and it suddenly stopped working today because now my dataframes are pyspark.sql.connect.dataframe.DataFrame

Re: pyspark.sql.connect.dataframe.DataFrame vs pyspark.sql.DataFrame

Gleydson404 — Thu, 21 Aug 2025 08:44:11 GMT

I have found a work around for this issue. Basically, I create a dummy_df and then I check if the dataframe I want to check has the same type as the dummy_df.

def get_dummy_df() -> DataFrame: """ Generates a dummy DataFrame with a range of integers. This method creates a DataFrame containing integers starting from 0 up to (but not including) 2 using the current Spark session. Returns: DataFrame: A Spark DataFrame containing a single column with the values [0, 1]. """ spark_session = SparkSession.builder.appName( "dummy_df" ).getOrCreate() return spark_session.range(0, 2) def is_spark_df(df_to_check: DataFrame) -> bool: """ Checks if the provided object is a Spark DataFrame. This function compares the type of the provided DataFrame with a dummy DataFrame created using the `get_dummy_df()` function. This is necessary because in Databricks, depending on the cluster configuration, the DataFrame type can vary. If you import `pyspark.sql.dataframe`, your type check may fail because Databricks can provide `pyspark.sql.connect.dataframe`. Parameters: df_to_check (DataFrame): The DataFrame instance to check. Returns: bool: True if the object is a Spark DataFrame, False otherwise. For more information on this issue, please see: https://community.databricks.com/t5/data-engineering/pyspark-sql-connect-dataframe-dataframe-vs-pyspark-sql-dataframe/td-p/71055 """ return type(df_to_check) == type(get_dummy_df())

Regards,

Gleydson C.