clean up docstrings

Signed-off-by: varun-edachali-dbx <varun.edachali@databricks.com>

Author: varun-edachali-dbx

src/databricks/sql/backend/databricks_client.py

@@ -90,8 +90,10 @@ def execute_command(
     ) -> Union["ResultSet", None]:
         """
         Executes a SQL command or query within the specified session.
+
         This method sends a SQL command to the server for execution and handles
         the response. It can operate in both synchronous and asynchronous modes.
+
         Args:
             operation: The SQL command or query to execute
             session_id: The session identifier in which to execute the command
@@ -103,10 +105,12 @@ def execute_command(
             parameters: List of parameters to bind to the query
             async_op: Whether to execute the command asynchronously
             enforce_embedded_schema_correctness: Whether to enforce schema correctness
+
         Returns:
             If async_op is False, returns an ExecuteResponse object containing the
             query results and metadata. If async_op is True, returns None and the
             results must be fetched later using get_execution_result().
+
         Raises:
             ValueError: If the session ID is invalid
             OperationalError: If there's an error executing the command
@@ -177,13 +181,17 @@ def get_execution_result(
     ) -> "ResultSet":
         """
         Retrieves the results of a previously executed command.
+
         This method fetches the results of a command that was executed asynchronously
         or retrieves additional results from a command that has more rows available.
+
         Args:
             command_id: The command identifier for which to retrieve results
             cursor: The cursor object that will handle the results
+
         Returns:
             ExecuteResponse: An object containing the query results and metadata
+
         Raises:
             ValueError: If the command ID is invalid
             OperationalError: If there's an error retrieving the results
@@ -201,15 +209,19 @@ def get_catalogs(
     ) -> "ResultSet":
         """
         Retrieves a list of available catalogs.
+
         This method fetches metadata about all catalogs available in the current
         session's context.
+
         Args:
             session_id: The session identifier
             max_rows: Maximum number of rows to fetch in a single batch
             max_bytes: Maximum number of bytes to fetch in a single batch
             cursor: The cursor object that will handle the results
+
         Returns:
             ExecuteResponse: An object containing the catalog metadata
+
         Raises:
             ValueError: If the session ID is invalid
             OperationalError: If there's an error retrieving the catalogs
@@ -228,17 +240,21 @@ def get_schemas(
     ) -> "ResultSet":
         """
         Retrieves a list of schemas, optionally filtered by catalog and schema name patterns.
+
         This method fetches metadata about schemas available in the specified catalog
         or all catalogs if no catalog is specified.
+
         Args:
             session_id: The session identifier
             max_rows: Maximum number of rows to fetch in a single batch
             max_bytes: Maximum number of bytes to fetch in a single batch
             cursor: The cursor object that will handle the results
             catalog_name: Optional catalog name pattern to filter by
             schema_name: Optional schema name pattern to filter by
+
         Returns:
             ExecuteResponse: An object containing the schema metadata
+
         Raises:
             ValueError: If the session ID is invalid
             OperationalError: If there's an error retrieving the schemas
@@ -259,8 +275,10 @@ def get_tables(
     ) -> "ResultSet":
         """
         Retrieves a list of tables, optionally filtered by catalog, schema, table name, and table types.
+
         This method fetches metadata about tables available in the specified catalog
         and schema, or all catalogs and schemas if not specified.
+
         Args:
             session_id: The session identifier
             max_rows: Maximum number of rows to fetch in a single batch
@@ -270,8 +288,10 @@ def get_tables(
             schema_name: Optional schema name pattern to filter by
             table_name: Optional table name pattern to filter by
             table_types: Optional list of table types to filter by (e.g., ['TABLE', 'VIEW'])
+
         Returns:
             ExecuteResponse: An object containing the table metadata
+
         Raises:
             ValueError: If the session ID is invalid
             OperationalError: If there's an error retrieving the tables