Server

Control plane URL the driver authenticates and routes through. Required.

Category: connection-string

Syntax

Server=<url>

Description

## Required `Server=` is required for every connection that does not resolve through a DSN with `Server=` already configured. It is the control-plane URL: the host the driver authenticates against and asks for compute-node routing. ## Resolution order If `Server=` is missing from the connection string, the driver falls back in this order: 1. The DSN's `Server=` entry in `odbc.ini` (Linux / macOS) or the registry (Windows). 2. The aliases `HOST=` plus `PORT=` if both are present (synthesised as `http://HOST:PORT` so existing connection strings from other vendors work without rewriting). If no source supplies a value, `SQLDriverConnect` returns `08001` with a message that names the missing key. ## Compute path `Server=` only addresses the control plane. The actual data path can target a different host: when the control plane recommends a compute node, or when `ComputeServer=` overrides the recommendation, the driver opens a second connection to that host.

Parameters

Name	Type	Description
`Server`		Absolute URL of the Delta Forge control plane, including scheme and optional port. Example: `https://df.example.com`. The driver constructs API paths against this root; do not include any path component yourself.

Examples

Server=https://df.example.com

Server=https://controlplane.acme.com:9224

Pitfalls

Trailing slashes are tolerated but unnecessary. `Server=https://df.example.com/` and `Server=https://df.example.com` resolve identically.
Including a path component (`Server=https://df.example.com/some/path`) is rejected at validate time. The driver constructs paths itself.
An IPv6 literal in the URL must be bracketed: `Server=https://[2001:db8::1]:9224`. Unbracketed IPv6 fails URL parsing inside the diagnostic chain.