# Configuring available server connections for a workspace

When you add a database connection to a database, or export data to an external database, you select the server connection to use.

From the **Server Connections** section of the workspace settings page, you manage the available server connections for the workspace.

<figure><img src="/files/mRIfGQ0AUQGt3UpzZIJ7" alt=""><figcaption><p>Server Connections section of workspace settings with a defined server connection.</p></figcaption></figure>

When you create a server connection during database connection configuration or data export, Fabricate automatically adds the server connection to the list.

## Adding a server connection

From the **Server Connections** list, to add a server connection:

### Selecting the platform and providing name

1. Click **Add Server Connection**.

<figure><img src="/files/6VJbb14onricEvMcAh9u" alt=""><figcaption><p>New Server Connection panel to create a server connection</p></figcaption></figure>

2. On the **New Server Connection** panel, to use a connection string to populate the connection fields, in the **Connection URL** field, paste the string.\
   \
   When it populates the fields, Fabricate sets **Name** to the host value. You can change the name to a different
3. If you do not use a connection string, then:
   1. From the **Platform** dropdown list, select the server platform.
   2. In the **Name** field, provide a name to use to identify the server connection.
   3. Provide the [connection details](#connection-details).
4. To test the connection, click **Test Connection**.
5. To save the connection, click **Create Server Connection**.

## Editing a server connection

To edit a server connection:

1. Click the **Edit** option for the server connection.

<figure><img src="/files/6W4UPfshPhhnikbkNSXO" alt=""><figcaption><p>Edit Server Connection panel</p></figcaption></figure>

2. On the connection details panel, update the [connection details](#connection-details).\
   \
   Note that Fabricate does not display the existing content of password, secret, or private key fields. If you are not changing those values for a server connection, then leave the field empty.
3. To test the updated configuration, click **Test Connection**.
4. To save the changes, click **Save Changes**.

## Connection details

### Platforms other than Databricks or Snowflake

For platforms other than Databricks and Snowflake, the connection fields are:

1. In the **Host** field, provide the hostname for the server.
2. In the **Port** field, provide the port to connect through.
3. From the **TLS** dropdown list, select whether to enable Transport Layer Security (TLS).
4. In the **Username** field, provide the username to use to make the connection.
5. In the **Password** field, provide the password.

### Databricks

For Databricks:

<figure><img src="/files/ILRRJ8nEh1gESQs81tLB" alt=""><figcaption><p>New Server Connection panel for a Databricks connection</p></figcaption></figure>

1. In the **Host** field, provide the host where the database is located.
2. From the **Credential Type** dropdown list, select the type of authentication to use. The options are:
   * **Service Principal**
   * **Personal Access Token**
3. For **Service Principal** authentication:
   1. In the **Client ID** field, provide the client identifier.
   2. In the **Secret** field, provide the secret that is associated with the client identifier.
4. For **Personal Access Token** authentication, in the **Access Token** field, provide the access token to authenticate to the database.
5. In the **Warehouse ID** field, provide the data warehouse for the data.

### Snowflake

For Snowflake:

<figure><img src="/files/yIg8M508kdrSVz3e15HI" alt=""><figcaption><p>New Server Connection panel for a Snowflake connection</p></figcaption></figure>

1. In the **Account Identifier** field, provide the identifier for the Snowflake account that owns the connection.
2. From the **Credential Type** dropdown list, select the type of credentials to use for the connection. The options are:
   * **Password**
   * **RSA Key Pair**
3. If you select **Password**:
   1. In the **Username** field, provide the username for the connection.
   2. In the **Password** field, provide the password for the connection.
4. If you select **RSA Key Pair**:
   1. In the **Username** field, provide the username for the connection.
   2. In the **Private** Key field, paste an unencrypted, PEM-encoded private key.

<figure><img src="/files/OfgAvkuTnow6xRVJvhHz" alt=""><figcaption><p>Fields for the RSA Key Pair authentication option for a Snowflake connection</p></figcaption></figure>

5. In the **Warehouse** field, provide the name of the warehouse that runs the connection.
6. In the **Role** field, provide the name of the role to use for the connection.

## Deleting a server connection

You cannot delete a server connection that is either:

* Used in a database connection.
* The server connection for a database export target. Before you can delete the server connection, you must remove the export target.

From the **Server Connections** list, to delete a connection, click its **Delete** option.


---

# 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.tonic.ai/fabricate/workspaces/workspace-server-connections.md?ask=<question>
```

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.