Forum Discussion

sharp1FL's avatar
sharp1FL
Helper I
1 year ago
Solved

UnsupportedArtifactException SQLDatabase in Python notebook tsql cell

I am trying to connect to our Fabric SQL orchestration database using the tsql command as documented here:

https://blog.fabric.microsoft.com/en-us/blog/connect-to-your-sql-database-in-fabric-using-python-notebook?ft=Databases:category

 

%%tsql -artifact <ORCH_DB_NAME> -type SQLDatabase -bind df2
SELECT * FROM dbo.<orch_tablename>
 
I get the following error:
UnsupportedArtifactException: Artifact type SQLDatabase is not supported to connect

 

This seems so simple. What am I doing incorrectly?

10 Replies

  • v-hashadapu's avatar
    v-hashadapu
    Community Support

    Hi sharp1FL , Thank you for reaching out to the Microsoft Community Forum.

     

    Microsoft Fabric notebooks do not support connecting to SQLDatabase artifacts using the %tsql magic command. %tsql in Fabric notebooks currently only supports querying data from Lakehouse and Warehouse artifacts. Attempting to use any other artifact type will result in this exact exception.

     

    Ensure your orchestration data is available in a supported artifact like a Warehouse or Lakehouse, then modify your code as follows:

    %%tsql -artifact MyWarehouse -bind df2

    SELECT * FROM dbo.my_table

     

    Author and run T-SQL notebooks in Microsoft Fabric - Microsoft Fabric | Microsoft Learn

    Run T-SQL code in Fabric Python notebooks - Microsoft Fabric | Microsoft Learn

  • Hi sharp1FL 

     

    You should understand that difference between data lake, delta lake and linux operating system. Before going ahead,

     

    Here you have to use T-SQL in Fabric Warehouse. 

     

     

  • v-hashadapu's avatar
    v-hashadapu
    Community Support

    Hi sharp1FL , hope you are doing great. May we know if your issue is solved or if you are still experiencing difficulties. Please share the details as it will help the community, especially others with similar issues.

  • Thanks for the clarification, though I am disappointed. 

     

    I'm using SQL because it makes more sense than delta for orchestration. Would there be additional overhead or performance implications for using the data warehouse artifact for CRUD operations on the orchestration tables? 

      • v-hashadapu's avatar
        v-hashadapu
        Community Support

        Hi sharp1FL , Thank you for reaching out to the Microsoft Community Forum.

         

        Yes, using a Warehouse for orchestration tables works, but it’s not a perfect substitute for a SQL database. Fabric Warehouses are optimized for analytical queries, not transactional operations. Frequent INSERT/UPDATE/DELETEs can be slower and less efficient than in a SQL database and transactional guarantees (like row-level locking) are limited.

         

        For light or batched orchestration logic (e.g., logging or status updates), it’s a workable short-term solution. But for high-frequency or dependency-sensitive writes, you may hit performance limits. Once SQL database support in notebooks is live, it’ll be the better fit.

         

        Limitations of Fabric Data Warehouse - Microsoft Fabric | Microsoft Learn

  • sukkaur's avatar
    sukkaur
    Microsoft Employee

    sharp1FL  - Please try TSQL magic command again. There was an error and it's fixed. Thanks