e04ed9c211
CF: Deploy Dev Docs / deploy (push) Has been cancelled
Sync Labels / build (push) Has been cancelled
tests / unit tests (macos-latest) (push) Has been cancelled
tests / unit tests (windows-latest) (push) Has been cancelled
tests / unit tests (ubuntu-latest) (push) Has been cancelled
65 lines
3.8 KiB
Markdown
65 lines
3.8 KiB
Markdown
---
|
|
title: "SQL Server Source"
|
|
linkTitle: "Source"
|
|
type: docs
|
|
weight: 1
|
|
description: >
|
|
SQL Server is a relational database management system (RDBMS).
|
|
no_list: true
|
|
---
|
|
|
|
## About
|
|
|
|
[SQL Server][mssql-docs] is a relational database management system (RDBMS)
|
|
developed by Microsoft that allows users to store, retrieve, and manage large
|
|
amount of data through a structured format.
|
|
|
|
[mssql-docs]: https://www.microsoft.com/en-us/sql-server
|
|
|
|
|
|
|
|
## Available Tools
|
|
|
|
{{< list-tools >}}
|
|
|
|
## Requirements
|
|
|
|
### Database User
|
|
|
|
This source only uses standard authentication. You will need to [create a
|
|
SQL Server user][mssql-users] to login to the database with.
|
|
|
|
[mssql-users]:
|
|
https://learn.microsoft.com/en-us/sql/relational-databases/security/authentication-access/create-a-database-user?view=sql-server-ver16
|
|
|
|
## Example
|
|
|
|
```yaml
|
|
kind: source
|
|
name: my-mssql-source
|
|
type: mssql
|
|
host: 127.0.0.1
|
|
port: 1433
|
|
database: my_db
|
|
user: ${USER_NAME}
|
|
password: ${PASSWORD}
|
|
# encrypt: strict
|
|
```
|
|
|
|
{{< notice tip >}}
|
|
Use environment variable replacement with the format ${ENV_NAME}
|
|
instead of hardcoding your secrets into the configuration file.
|
|
{{< /notice >}}
|
|
|
|
## Reference
|
|
|
|
| **field** | **type** | **required** | **description** |
|
|
|-----------|:--------:|:------------:|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| type | string | true | Must be "mssql". |
|
|
| host | string | true | IP address to connect to (e.g. "127.0.0.1"). |
|
|
| port | string | true | Port to connect to (e.g. "1433"). |
|
|
| database | string | true | Name of the SQL Server database to connect to (e.g. "my_db"). |
|
|
| user | string | true | Name of the SQL Server user to connect as (e.g. "my-user"). |
|
|
| password | string | true | Password of the SQL Server user (e.g. "my-password"). |
|
|
| encrypt | string | false | Encryption level for data transmitted between the client and server (e.g., "strict"). If not specified, defaults to the [github.com/microsoft/go-mssqldb](https://github.com/microsoft/go-mssqldb?tab=readme-ov-file#common-parameters) package's default encrypt value. |
|