Oauth2 feature added

.gitignore

@@ -41,6 +41,7 @@ LICENSE.txt
 /IntegrationTests/
 /opensearchenlist/
 /sqlodbc/
+/output/
 /PerformanceTests/
 /UnitTests/
 *.filters
@@ -60,3 +61,6 @@ CTestTestfile.cmake
 /src/PowerBIConnector/obj/
 /src/PowerBIConnector/.vs/
 src/vcpkg_installed/
+/extensionBiConnector/
+/comparisonBiConnector/
+/extensionTableauConnector/

CppProperties.json

@@ -0,0 +1,21 @@
+{
+  "configurations": [
+    {
+      "inheritEnvironments": [
+        "msvc_x64"
+      ],
+      "name": "x64-Release",
+      "includePath": [
+        "${env.INCLUDE}",
+        "${workspaceRoot}\\**"
+      ],
+      "defines": [
+        "WIN32",
+        "NDEBUG",
+        "UNICODE",
+        "_UNICODE"
+      ],
+      "intelliSenseMode": "windows-msvc-x64"
+    }
+  ]
+}

README.md

@@ -1,6 +1,6 @@
 # OpenSearch ODBC Driver
 
-OpenSearchODBC is a read-only ODBC driver for Windows and Mac for connecting to OpenSearch SQL support.
+OpenSearchODBC is a read-only ODBC driver for Windows and Mac for connecting to OpenSearch SQL support. This driver version allows to levereage on Oauth2 authentication/authorization. 
 
 ### ODBC Driver
 

bi-connectors/PowerBIConnector/AmazonOpenSearchService.md

@@ -52,7 +52,7 @@
 
 ## Troubleshooting 
 
-* If you get the following error, please install the [OpenSearch SQL ODBC Driver](https://docs-beta.opensearch.org/search-plugins/sql/odbc/).
+* If you get the following error, please install the [OpenSearch SQL ODBC Driver](https://opensearch.org/docs/latest/search-plugins/sql/sql/odbc/).
 
 <img src="img/pbi_error_driver_not_installed.png" width="350">
 

bi-connectors/PowerBIConnector/OpenSearchProject.md

@@ -23,36 +23,53 @@
 ## Connect to OpenSearch Project
 1. Open Power BI Desktop.
 
-2. Click on **Home** > **Get Data** > **More** > **Other**. Select **OpenSearch Project**. Click on **Connect**.
+2. If necessary clear the previous permissions.
+
+<img src="img/powerbi_cached.png" width="500">
+
+3. Click on **Home** > **Get Data** > **More** > **Other**. Select **OpenSearch Project**. Click on **Connect**.
 
 <img src="img/pbi_select_connector.png" width="500">
 
-3. You will get a warning for using a third-party service. Click on **Continue**.
+4. You will get a warning for using a third-party service. Click on **Continue**.
 
 <img src="img/pbi_third_party_warning.png" width="500">
 
-4. Enter host and port values and select your preferred SSL and Certificate validation options. Click on **OK**.
+5. Enter host and port values and select your preferred SSL and Certificate validation options. Click on **OK**.
 
 <img src="img/pbi_connection_string_options.png" width="500">
 
-5. Select authentication option. Enter credentials if required and click on **Connect**.
+6. Select authentication option. Enter credentials if required and click on **Connect**.
 
 <img src="img/pbi_auth.png" width="500">
 
-6. Select required table. Data preview will be loaded.
+7. Select required table. Data preview will be loaded.
 
 <img src="img/pbi_data_preview.png">
 
-7. Click on **Load**.
+8. Click on **Load**.
 
-8. Select required columns for creating a graph.
+9. Select required columns for creating a graph.
 
 <img src="img/pbi_simple_graph.png">
 
+## Set up Oauth2
+
+* In the same folder of the source files to build put a JSON file filling the three fields required in the template provided.
+
+## Login with Oauth2
+
+1.  Select the `OAUTH2` authentication and click on **Sign In**
+
+<img src="img/Oauth2_init.png" width="500">
+
+2.  After provided the user-id and the user-secret, click on **Connect**
+
+<img src="img/Oauth2_signedIn.png" width="500">
 
 ## Troubleshooting 
 
-* If you get the following error, please install the [OpenSearch SQL ODBC Driver](https://docs-beta.opensearch.org/search-plugins/sql/odbc/).
+* If you get the following error, please install the [OpenSearch SQL ODBC Driver](https://opensearch.org/docs/latest/search-plugins/sql/sql/odbc/).
 
 <img src="img/pbi_error_driver_not_installed.png" width="350">
 

bi-connectors/PowerBIConnector/README.md

@@ -3,6 +3,18 @@
 The Power BI connector is available to download from the automated CI workflow: [link](https://github.com/opensearch-project/sql-odbc/actions/workflows/bi-connectors.yml).
 The release snapshots are also available here: [OpenSearch Project](OpenSearchProject.mez) and [Amazon OpenSearch Service](AmazonOpenSearchService.mez).
 
+## Connector Development
+
+The development of the connector is related to the PoweQuery SDK for [VisualStudio](https://marketplace.visualstudio.com/items?itemName=Dakahn.PowerQuerySDK) or for Visual Studio Code from the `Extensions` left tab. 
+
+Is possible to initialize a project for example in VSC with <img src="img/powerquery_SDK.png" width="200">
+
+The main logic is in `.pq` file (not `.query.pq`) and is not possible to have multiple files of this extension. In connector development there are limitation to the functionalities that is possibile to use as the [data source functions](https://learn.microsoft.com/en-us/power-query/handling-data-access#data-source-functions). The reference and guides of [Power Query M](https://learn.microsoft.com/en-us/powerquery-m/) is available.
+
+After created the program it is required to run compiling and packaging phases as <img src="img/build_task.png" width="600">. 
+
+The output `.mez` file will appear in `bin\AnyCPU\Debug` of the same folder.
+
 ## Connector Install
 
 1. Put connector `mez` file into: `C:\Users\%USERNAME%\Documents\Power BI Desktop\Custom Connectors`.

bi-connectors/PowerBIConnector/power_bi_support.md

@@ -2,8 +2,8 @@
 
 ## Prerequisites
 * Microsoft Power BI Desktop
-* [OpenSearch](https://docs-beta.opensearch.org/opensearch/install/index/)
-* [OpenSearch SQL ODBC driver](https://docs-beta.opensearch.org/search-plugins/sql/odbc/)
+* [OpenSearch](https://opensearch.org/docs/latest/install-and-configure/install-opensearch/index/)
+* [OpenSearch SQL ODBC driver](https://opensearch.org/docs/latest/search-plugins/sql/sql/odbc/)
 * [OpenSearchProject.mez](OpenSearchProject.mez) or [AmazonOpenSearchService.mez](AmazonOpenSearchService.mez)
 * Optional: [sqlodbc_import.pbids](PBIDSExamples/sqlodbc_import.pbids) to help with repeated connections to the same server 
 
@@ -86,7 +86,7 @@ It will take you straight to the **Navigator** window for selecting the tables f
 
 ## Troubleshooting 
 
-* If you get an following error, please install [OpenSearch SQL ODBC Driver](https://docs-beta.opensearch.org/search-plugins/sql/odbc/).
+* If you get an following error, please install [OpenSearch SQL ODBC Driver](https://opensearch.org/docs/latest/search-plugins/sql/sql/odbc/).
 
 <img src="img/pbi_error_driver_not_installed.png" width="350">
 

bi-connectors/PowerBIConnector/src/OauthConf.json

@@ -0,0 +1,5 @@
+{
+	"ClientId": "<User ID>",
+	"ClientSecret": "<User secret>",
+	"IDPurl": "<Endpoint of the IdP>"
+}