# Sigma Computing
## Before you start
To connect Sigma to Select Star, you will need...
* Admin access to your Sigma account.
Complete the following steps to enable metadata, lineage, and popularity of your Sigma workbooks in Select Star.
1. [Identify your Sigma API request URL](#id-1.-identify-your-sigma-api-request-url)
2. [Generate API Client ID and Secret](#id-2.-generate-api-client-id-and-secret)
3. [Connect Sigma API to Select Star](#id-3.-connect-sigma-api-to-select-star)
## 1. Identify your Sigma API request URL
The URL Select Star uses to send API requests depends on the [cloud your Sigma organization is hosted on](https://help.sigmacomputing.com/docs/region-warehouse-and-feature-support).
View your **Base URL** in the **Administration** section of Sigma. Go to **Administration** > **Developer Access** > **API base URL**. Keep this information for the next steps.
## 2. Generate API client ID and secret
To generate API client credentials, you must be assigned the **Admin** account type.
1. From **Sigma Home**, open **Administration**, or click your user avatar to open the user menu and select **Administration**.
2. In the side panel, select **Developer Access**.
3. Click **Create new** to set up new credentials.
1. The **Create client credentials** modal opens.
4. For **Select scopes**, select the REST API checkbox to enable the use of these credentials for the API.
5. For **Name**, enter a unique name to identify the credentials. For example, "**Select Star**".
6. \[optional] For **Description**, enter a description of the purpose of the credentials. For example, "Token used to connect Select Star integration"
7. For **Owner**, set yourself as the owner, OR search for and select a member of your organisation with whom to associate the credentials.
1. Note: The API secret uses the account type permissions assigned to this user.
2. **Select Star recommends selecting an Admin as the Owner in order to fetch all workbooks available in your Sigma instance.**
8. Click **Create** to generate the credentials.
9. Copy the client ID and secret, and securely store them for the next steps.
## 3. Connect Sigma API to Select Star
Go to the Select Star **Settings**. Click **Data** in the sidebar, then **+ Add** to create a new Data Source.
Choose **Sigma** in the Source Type dropdown and provide the following information:
* **Display Name:** This value is `Sigma` by default, but you can override it if desired.
* **API Client ID:** The API Client ID from [step 2](#id-2.-generate-api-client-id-and-secret) above.
* **API Client Secret:** The API Secret Token from [step 2](#id-2.-generate-api-client-id-and-secret) above.
* **API Server:** This is based on your Sigma cloud configuration. You need to use the API request URL from [step 1](#id-1.-identify-your-sigma-api-request-url) above.
* **DB Connection:** This is based on the database connection used in your Sigma instance.
* **DB Username:** This is the database user configured in your Sigma instance.
{% hint style="info" %}
In order to show the cross-platform lineage, the DB Connection & DB Username need to match with your Sigma connection details.
{% endhint %}
{% content-ref url="../learning-data/getting-started-sigma" %}
[getting-started-sigma](https://docs.selectstar.com/learning-data/getting-started-sigma)
{% endcontent-ref %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.selectstar.com/integrations/sigma-computing.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
