Set up the Fabric connector

Before you start

Make sure you have the credentials to connect your Fabric instance. Use DefaultCredentials to authenticate the connector. This makes it very flexible, with multiple options for specifying credentials, which are client credentials, user login, or managed identities.
Check the server requirements for the connector.
Create a configuration file according to the configuration settings. The file must be in YAML format.

Set up the connector

Windows standalone
Windows service
Docker

Download the executable

Download the fabric-connector-standalone-{VERSION}-win32.exe file via the download links available from the Cognite Fabric Connector section on the Extract data page in the CDF user interface.

Save the file

Save the file in a folder.

Run the connector

Open a command line window and run the file with a configuration file as an argument.In this example, the configuration file is named config.yml and saved in the same folder as the executable file:

fabric-connector-standalone-<VERSION>-win32.exe ./config.yml

Download the service executable

Download the fabric-connector-service-{VERSION}-win32.exe file via the download links available from the Cognite Fabric Connector section on the Extract data page on the CDF homepage.

Save files in same directory

Save the file to the same directory as a configuration file named config.yaml. This must be the exact name of the file.

Install the service

As an administrator, open up the command line window in the folder you placed the executable file and the configuration file and run the following command:

.\fabric-connector-service-<VERSION>-win32.exe install

Configure the service

Open the Services app in Windows and find the Cognite Fabric Connector service.
Right-click the service and select Properties.
Configure the service according to your requirements.

The connector is available as a Docker container that is pre-built with a configuration that connects to CDF and downloads the configuration from an extraction pipeline in CDF. You can use the example config as a starting point.Enter this docker run statement with the following options:

docker run starts a new container.
--name fabric-connector names the container fabric-connector. This recognizes the connector when running docker ps and stops the connector with docker stop db-connector.
--network=host grants the container full network access. This is required to push metrics and connect to CDF.
cognite/fabric-connector:<version> is the name of the image. Replace <version> with the version you’ll run.
Set the environment variables using the -e VARNAME=value parameters: COGNITE_BASE_URL, COGNITE_PROJECT, COGNITE_TOKEN_URL, COGNITE_CLIENT_ID, COGNITE_CLIENT_SECRET, COGNITE_EXTRACTION_PIPELINE.
Set the other environment variables mentioned in your config yaml stored in the extraction pipeline.
Set the managed identity on the container or set the environment variables for DefaultCredentials.

Data engineering

​Before you start

​Set up the connector

Before you start

Set up the connector