Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Liz norris - KX kdb Insights Enterprise Connector #570

Open
wants to merge 23 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 22 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions powerquery-docs/connectors/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,7 @@ The connectors are listed in alphabetical order in separate tables for each lett
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
| :::image type="content" border="false" source="media/index/kognitwin-64.png" alt-text="Kognitwin.":::<br/>**Kognitwin**<br/>By Kongsberg | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kognitwin in Excel"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Kognitwin in Power BI (Semantic models)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Kognitwin in Power BI (Dataflows)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Kognitwin in Fabric (Dataflow Gen2)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kognitwin in Power Apps (Dataflows)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kognitwin in Customer Insights (Dataflows)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kognitwin in Analysis Services"::: |
| :::image type="content" border="false" source="media/index/kql-database-64.png" alt-text="KQL Database." link="kql-database.md"::: [<br/>**KQL Database**](kql-database.md)<br/>By Microsoft | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - KQL Database in Excel"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KQL Database in Power BI (Semantic models)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KQL Database in Power BI (Dataflows)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KQL Database in Fabric (Dataflow Gen2)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KQL Database in Power Apps (Dataflows)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KQL Database in Customer Insights (Dataflows)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - KQL Database in Analysis Services"::: |
| :::image type="content" border="false" source="media/index/kx-kdb-insights-enterprise.png" alt-text="KX kdb Insights Enterprise." link="kx-kdb-insights-enterprise.md"::: [<br/>**KX kdb Insights Enterprise**](kx-kdb-insights-enterprise.md)<br/>By KX Systems Inc. | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - KX kdb Insights Enterprise in Excel"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KX kdb Insights Enterprise in Power BI (Semantic models)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KX kdb Insights Enterprise in Power BI (Dataflows)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KX kdb Insights Enterprise in Fabric (Dataflow Gen2)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KX kdb Insights Enterprise in Power Apps (Dataflows)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - KX kdb Insights Enterprise in Customer Insights (Dataflows)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - KX kdb Insights Enterprise in Analysis Services"::: |
| :::image type="content" border="false" source="media/index/kyligence-64.png" alt-text="Kyligence.":::<br/>**Kyligence**<br/>By Kyligence | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kyligence in Excel"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Kyligence in Power BI (Semantic models)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Kyligence in Power BI (Dataflows)"::: | :::image type="content" border="false" source="media/index/yes.png" alt-text="Supported - Kyligence in Fabric (Dataflow Gen2)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kyligence in Power Apps (Dataflows)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kyligence in Customer Insights (Dataflows)"::: | :::image type="content" border="false" source="media/index/no.png" alt-text="Not supported - Kyligence in Analysis Services"::: |
| [![Kyvos ODBC (Beta).](media/index/kyvos-odbc-64.png)<br/>**Kyvos ODBC (Beta)**](kyvos-odbc.md)<br/>By Kyvos Insights | ![Not supported - Kyvos ODBC in Excel](media/index/no.png) | ![Supported - Kyvos ODBC in Power BI (Semantic models)](media/index/yes.png) | ![Supported - Kyvos ODBC in Power BI (Dataflows)](media/index/yes.png) | ![Supported - Kyvos ODBC in Fabric (Dataflow Gen2)](media/index/yes.png) | ![Not supported - Kyvos ODBC in Power Apps (Dataflows)](media/index/no.png) | ![Not supported - Kyvos ODBC in Customer Insights (Dataflows)](media/index/no.png) | ![Not supported - Kyvos ODBC in Analysis Services](media/index/no.png) |

Expand Down
97 changes: 97 additions & 0 deletions powerquery-docs/connectors/kx-kdb-insights-enterprise.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
---
title: KX kdb Insights Enterprise Power Query Connector (Beta)
description: Provides basic information, prerequisites, and instructions on how to connect to kdb Insights Enterprise
author: liznorris
ms.date: 11/15/2024
ms.author: dougklo
---

# KX kdb Insights Enterprise Power Query Connector (Beta)

> [!NOTE]
> The following connector article is provided by KX Systems Inc., the owner of this connector and a member of the Microsoft Power Query Connector Certification Program. If you have questions regarding the content of this article or have changes you would like to see made to this article, visit the [KX](https://www.kx.com) website and use the support channels there.


## Summary

| Item | Description |
| ------------------------------ | --------------------------- |
| Release State | General Availability |
| Products | Power BI (Semantic models)<br>Power BI (Dataflows)<br>Fabric (Dataflow Gen2) |
DougKlopfenstein marked this conversation as resolved.
Show resolved Hide resolved
| Authentication Types Supported | Username/Password<br/>OAuth |

The connector enables Microsoft Power BI users to remotely connect, explore, query data, preview tables, and harness the power and performance of kdb Insights Enterprise analytics before importing datasets into Power BI for visualization.


## Prerequisites

Ensure the following prerequisities are met before proceeding:

* kdb Insights Enterprise 1.11.0 or above is [installed](https://code.kx.com/insights/enterprise/getting-started/index.html) and running at least one database.

* Permissions to query data on the running databases.


## Capabilities supported

* Import
* Filtering
* Aggregation
* Group By


## Connect to kdb Insights Enterprise

To make the connection, follow these steps:

1. Open Microsoft Power BI Desktop or Power BI Online.

1. Select **Get Data**:
* For **Power BI Desktop**, click `Get Data -> More` from the **Home** tab in the upper ribbon.
* For **Power BI Online**, in the Get Data experience, select the `Dataflow` category.

1. Search for **KX kdb**.

1. Select **KX kdb Insights Enterprise**.

1. Click **Connect**.

1. Enter the URL for your kdb Insights Enterprise deployment.

1. Click **OK**.

1. You are prompted to sign in if you have not signed in recently or have never signed in:

* If you have not signed in recently or have never signed in click **Sign in**. The button is named **Sign in as a different user** if your login credentials have expired or are no longer valid.

![KX Insights Enterprise instance information.](./media/kx-kdb-insights-enterprise/powerbi-signin.png)

1. If your credentials are valid, the Connector popup displays that you are currently signed in and you can click the **Connect** button.

![KX Insights Enterprise signin popup.](./media/kx-kdb-insights-enterprise/powerbi-signedin.png)

1. The **Navigator** dialog box displays all the running databases and tables for your chosen host on the left. Clicking on a table returns a preview of the selected data using the _kdb Insights Enterprise_ [getData REST API](https://code.kx.com/insights/api/database/query/get-data.html).

![KX Insights Enterprise preview page.](./media/kx-kdb-insights-enterprise/powerbi-preview.png)

## Navigator options

The [parameters](https://code.kx.com/insights/enterprise/integrations/powerbi/powerbi-import.html#parameters) available on the Navigator allow you to leverage the power of kdb Insights Enterprise analytics to filter, group, and aggregate data by restricting the data being loaded and bringing you the performance of the _kdb Insights database_.


| **Parameter** | **Details** |
| ------------- | -------------------------------------------------------------------------------- |
| Start Time | Applies to the partitioned column and will be ignored for non-partitioned tables |
| End Time | Applies to the partitioned column and will be ignored for non-partitioned tables |
| Filter | Filters out certain rows |
| Aggregation | Filters the columns and/or aggregates the rows being returned |
| Group By | Group the results of an aggregation based on specific columns |


## More resources

For more information visit the following resources:

* [kdb Insights Enterprise official documentation](https://code.kx.com/insights/enterprise/index.html).

* [KX kdb Insights Enterprise Power Query Connector documentation](https://code.kx.com/insights/enterprise/integrations/powerbi/powerbi-import.html).
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.