Views:

Related resources:

Explanation

Tutorials

How-to guides

You can install the Luminesce ODBC driver on a Windows computer to enable end users to query Luminesce providers directly from a familiar BI app such as PowerBI or Excel. Find out more about native BI integration.

To do this, you require:

  • The Luminesce ODBC driver MSI (contact us for delivery options)
  • Administrative privileges on a Windows 7 SP1+ computer
  • .NET Framework 4.7.2+

Installing the driver

  1. Launch the MSI in your preferred way, for example at the command line:
    msiexec /i Finbourne.Honeycomb.ODBCWin64.<version>.msi
    The MSI is currently unsigned, but it's safe to override any warnings:
  2. On the Custom Setup screen, we recommend the default option of installing both 32-bit and 64-bit builds (even on a 64-bit system, since a typical Excel installation is 32-bit):

Configuring driver settings

If you installed the 64-bit build:

  1. Search for the ODBC Data Sources (64-bit) app using the Windows Start menu:
  2. In the ODBC Data Source Administrator (64-bit) dialog, open the System DSN tab and choose to Configure the 64-bit build (the 32-bit build is listed but must be configured using the equivalent ODBC Data Source Administrator (32-bit) dialog):
  3. In the Luminesce ODBC Driver Configuration dialog, enter the prefix of your LUSID domain, for example acmecorp for an acmecorp.lusid.com domain:
  4. Choose an authentication method:
    • If you want an interactive login using the OAuth 2.0 PKCE flow, retain the default Embedded web browser option in the User authentication area (to use a browser component based on IE), or choose System web browser (which may satisfy CORS requirement in some environments). End users are prompted to sign in to LUSID using their username, password and MFA type the first time they run a query in a BI app, and subsequent times on token expiry (some apps may spawn multiple processes, which may each cause authentication challenges to occur).
    • To authenticate silently using the OAuth 2.0 Resource Owner flow, enter your Client application ID and Client secret in the Service authentication area. You are prompted for your LUSID username and password when you set up the new data source or the first time you run a query (depending on the app), but not subsequently. Note the client secret is stored in the system registry in plain text. See how to generate a client ID and secret.

If you installed the 32-bit build as well, repeat steps 1-4 for that variant.

Using a BI app to query a Luminesce provider

The following example showcases using Excel to query the Lusid.Instrument provider supplied by FINBOURNE.

Note: An end user must have a valid LUSID user account and sufficient access control permissions to query the chosen providers. Find out more.

  1. In Excel, select Get Data > From Other Sources > From ODBC from the Data menu:
  2. In the From ODBC dialog, choose Luminesce from the Data source name dropdown:
  3. When prompted, authenticate to LUSID using the username and password of a LUSID user.
  4. In the Navigator dialog, choose one or more Luminesce providers to query, for example Lusid.Instrument:
  5. Choose to Load data into Excel, for example:

Note you can write an explicit Luminesce SQL query in the Advanced options area of the From ODBC dialog (step 2):

Accessing logs

By default, logs are written to:

  • 32-bit build: C:\Windows\Temp\FinbourneLuminesce\ODBC32Logs
  • 64-bit build: C:\Windows\Temp\FinbourneLuminesce\ODBC64Logs

You can adjust the base directory (C:\Windows\Temp\FinbourneLuminesce) using the LOGPATH argument when running the MSI.

Uninstalling the driver

On Windows, you can uninstall the driver using Add or remove programs in the usual way, for example: