Skip to content

Commit

Permalink
Added note on use of supported APIs
Browse files Browse the repository at this point in the history
  • Loading branch information
MarkMpn committed Mar 23, 2022
1 parent ed7e9c9 commit 254fffe
Showing 1 changed file with 9 additions and 3 deletions.
12 changes: 9 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

By [Mark Carrington](https://markcarrington.dev/sql-4-cds/), supported by [Data8](https://www.data-8.co.uk/)

SQL 4 CDS provides an [engine](https://www.nuget.org/packages/MarkMpn.Sql4Cds.Engine/) and
[XrmToolBox tool](https://www.xrmtoolbox.com/plugins/MarkMpn.SQL4CDS/) for using standard SQL syntax to query data stored in Microsoft
Dataverse / Dynamics 365.
SQL 4 CDS provides an [engine](https://www.nuget.org/packages/MarkMpn.Sql4Cds.Engine/),
[XrmToolBox tool](https://www.xrmtoolbox.com/plugins/MarkMpn.SQL4CDS/) and [SSMS plugin](https://markcarrington.dev/sql-4-cds/sql-4-cds-ssms-edition/)
for using standard SQL syntax to query data stored in Microsoft Dataverse / Dynamics 365.

It converts the provided SQL query into the corresponding [FetchXML](https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/fetchxml-schema)
syntax and allows the associated query to be executed, including the following types of query:
Expand Down Expand Up @@ -34,6 +34,12 @@ SET statecode = 1, statuscode = 2
WHERE emailaddress1 IS NULL
```

<p style="background-color: #8ed1fc; padding: 1.25em">
Although you are writing SQL, you are not directly running the queries against the back-end database. All data retrieval and
modification is done through the supported Dataverse API. Running an UPDATE/INSERT/DELETE command against the underlying SQL
database is unsafe, but the same query in SQL 4 CDS is translated to safe & supported API requests.
</p>

The engine converts all the SQL syntax that has a direct equivalent in FetchXML. It also attempts to support some more SQL features
that do not have an equivalent in FetchXML, such as calculated fields, `HAVING` clauses and more.

Expand Down

0 comments on commit 254fffe

Please sign in to comment.