-
Notifications
You must be signed in to change notification settings - Fork 38
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
TDL-24621 + TDL-24622 Add guides for different MSSQL and MySQL enviro…
…nments (#986) * TDL-24621 add mssql guides * TDL-24622 add mysql guides
- Loading branch information
Showing
9 changed files
with
861 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
123 changes: 123 additions & 0 deletions
123
_destinations/microsoft-sql-server/guides/connecting-amazon-rds-for-sql-server.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,123 @@ | ||
--- | ||
# -------------------------- # | ||
# USING THIS TEMPLATE # | ||
# -------------------------- # | ||
|
||
## NEED HELP USING THIS TEMPLATE? SEE: | ||
## https://docs-about-stitch-docs.netlify.com/reference/destination-templates/destination-setup/ | ||
## FOR INSTRUCTIONS & REFERENCE INFO | ||
|
||
|
||
# -------------------------- # | ||
# Page Controls # | ||
# -------------------------- # | ||
|
||
title: Connecting an Amazon RDS for SQL Server Destination to Stitch | ||
permalink: /destinations/microsoft-sql-server/connecting-amazon-rds-for-sql-server-destination-to-stitch | ||
keywords: microsoft sql server, microsoft sql server data warehouse, microsoft sql server data warehouse, microsoft sql server etl, etl to microsoft sql server, microsoft sql server destination, sql server rds, relational database services | ||
summary: "Connect an Amazon RDS for SQL Server database to your Stitch account as a destination." | ||
|
||
content-type: "destination-setup" | ||
key: "mssql-rds-destination-setup" | ||
order: 2 | ||
|
||
toc: true | ||
layout: tutorial | ||
use-tutorial-sidebar: false | ||
|
||
|
||
# -------------------------- # | ||
# Destination Details # | ||
# -------------------------- # | ||
|
||
display_name: "Amazon RDS for SQL Server" | ||
name: "amazon-rds-microsoft-sql-server" | ||
|
||
type: "microsoft-sql-server" | ||
|
||
hosting-type: "amazon" | ||
|
||
ssh: true | ||
ssl: true | ||
port: 5432 | ||
|
||
api-type: "mssql_server" | ||
|
||
this-version: "1" | ||
|
||
|
||
# -------------------------- # | ||
# Introduction # | ||
# -------------------------- # | ||
|
||
intro: | | ||
# -------------------------- # | ||
# Requirements # | ||
# -------------------------- # | ||
|
||
requirements: | ||
- item: | | ||
{% assign destination = page %} | ||
**An up-and-running {{ destination.display_name }} instance.** Instructions for creating a {{ destination.display_name }} destination are outside the scope of this tutorial; our instructions assume that you have an instance up and running. For help getting started with {{ destination.display_name }}, refer to [AWS's documentation](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.SQLServer.html){:target="new"}. | ||
# -------------------------- # | ||
# Instructions # | ||
# -------------------------- # | ||
|
||
steps: | ||
- title: "Verify your Stitch account's data pipeline region" | ||
anchor: "verify-stitch-account-region" | ||
content: | | ||
{% include shared/whitelisting-ips/locate-region-ip-addresses.html first-step=true %} | ||
- title: "Configure database connection settings" | ||
anchor: "connect-settings" | ||
content: | | ||
{% include integrations/templates/configure-connection-settings.html %} | ||
- title: "Create a Stitch {{ destination.display_name }} database user" | ||
anchor: "create-database-user" | ||
content: | | ||
{% include note.html type="single-line" content="**Note**: You must have superuser privileges or the ability to create a user and grant privileges to complete this step." %} | ||
In the following tabs are the instructions for creating a Stitch {{ destination.display_name }} database user and explanations for the permissions Stitch requires. | ||
{% include destinations/templates/destination-user-setup.html %} | ||
- title: "Connect Stitch" | ||
anchor: "connect-stitch" | ||
content: | | ||
To complete the setup, you need to enter your {{ destination.display_name }} connection details into the {{ app.page-names.dw-settings }} page in Stitch. | ||
substeps: | ||
- title: "Enter connection details into Stitch" | ||
anchor: "enter-connection-details-into-stitch" | ||
content: | | ||
{% include shared/database-connection-settings.html type="general" %} | ||
- title: "Define SSH connection details" | ||
anchor: "define-ssh-connection-details" | ||
content: | | ||
{% include shared/database-connection-settings.html type="ssh" %} | ||
- title: "Define SSL connection details" | ||
anchor: "define-ssl-connection-details" | ||
content: | | ||
{% capture tsl-support-note %} | ||
SSL can only be used with versions of {{ destination.display_name }} that support TSL 1.2. Check which versions support it in [Microsoft's documentation]({{ site.data.destinations.microsoft-sql-server.resource-links.tls-support }}). | ||
{% endcapture %} | ||
{% include note.html type="single-line" content=tsl-support-note %} | ||
Check the **{{ defaults.field-names.ssl }}** checkbox. {{ defaults.field-copy.ssl }} | ||
- title: "Save the destination" | ||
anchor: "save-destination" | ||
content: | | ||
{% include shared/database-connection-settings.html type="finish-up" %} | ||
--- | ||
{% include misc/data-files.html %} | ||
{% assign destination = page %} |
122 changes: 122 additions & 0 deletions
122
_destinations/microsoft-sql-server/guides/connecting-azure-sql-database.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,122 @@ | ||
--- | ||
# -------------------------- # | ||
# USING THIS TEMPLATE # | ||
# -------------------------- # | ||
|
||
## NEED HELP USING THIS TEMPLATE? SEE: | ||
## https://docs-about-stitch-docs.netlify.com/reference/destination-templates/destination-setup/ | ||
## FOR INSTRUCTIONS & REFERENCE INFO | ||
|
||
|
||
# -------------------------- # | ||
# Page formatting & Controls # | ||
# -------------------------- # | ||
|
||
title: Connecting an Azure SQL Database Destination to Stitch | ||
permalink: /destinations/microsoft-sql-server/connecting-azure-sql-database-destination-to-stitch | ||
|
||
keywords: azure sql database, azure sql database data warehouse, azure sql database data warehouse, azure sql database etl, etl to azure sql database, azure sql database destination | ||
summary: "Connect an Azure SQL Database destination to your Stitch account." | ||
|
||
content-type: "destination-setup" | ||
key: "azure-sql-database-destination-setup" | ||
order: 2 | ||
|
||
toc: true | ||
layout: tutorial | ||
use-tutorial-sidebar: false | ||
|
||
|
||
# -------------------------- # | ||
# Destination Details # | ||
# -------------------------- # | ||
|
||
type: "microsoft-sql-server" | ||
display_name: "Azure SQL Database" | ||
name: "azure-sql-database" | ||
|
||
ssh: true | ||
ssl: true | ||
port: 1433 | ||
|
||
hosting-type: "microsoft-azure" # amazon, generic, microsoft, etc. | ||
|
||
api-type: "mssql_server" | ||
|
||
this-version: "1" | ||
|
||
|
||
# -------------------------- # | ||
# Introduction # | ||
# -------------------------- # | ||
|
||
intro: | | ||
# -------------------------- # | ||
# Setup Requirements # | ||
# -------------------------- # | ||
|
||
requirements: | ||
- item: | | ||
{% assign destination = page %} | ||
**An up-and-running {{ destination.display_name }} instance.** Instructions for creating a {{ destination.display_name }} destination are outside the scope of this tutorial; our instructions assume that you have an instance up and running. For help getting started with {{ destination.display_name }}, refer to [Microsoft's documentation](https://learn.microsoft.com/en-us/azure/azure-sql/){:target="new"}. | ||
# -------------------------- # | ||
# Setup Instructions # | ||
# -------------------------- # | ||
|
||
steps: | ||
- title: "Verify your Stitch account's data pipeline region" | ||
anchor: "verify-stitch-account-region" | ||
content: | | ||
{% include shared/whitelisting-ips/locate-region-ip-addresses.html first-step=true %} | ||
- title: "Configure database connection settings" | ||
anchor: "connect-settings" | ||
content: | | ||
{% include integrations/templates/configure-connection-settings.html %} | ||
- title: "Create a Stitch {{ destination.display_name }} database user" | ||
anchor: "create-database-user" | ||
content: | | ||
{% include note.html type="single-line" content="**Note**: You must have superuser privileges or the ability to create a user and grant privileges to complete this step." %} | ||
In the following tabs are the instructions for creating a Stitch {{ destination.display_name }} database user and explanations for the permissions Stitch requires. | ||
{% include destinations/templates/destination-user-setup.html %} | ||
- title: "Connect Stitch" | ||
anchor: "connect-stitch" | ||
content: | | ||
To complete the setup, you need to enter your {{ destination.display_name }} connection details into the {{ app.page-names.dw-settings }} page in Stitch. | ||
substeps: | ||
- title: "Enter connection details into Stitch" | ||
anchor: "enter-connection-details-into-stitch" | ||
content: | | ||
{% include shared/database-connection-settings.html type="general" %} | ||
- title: "Define SSH connection details" | ||
anchor: "define-ssh-connection-details" | ||
content: | | ||
{% include shared/database-connection-settings.html type="ssh" %} | ||
- title: "Define SSL connection details" | ||
anchor: "define-ssl-connection-details" | ||
content: | | ||
{% capture tsl-support-note %} | ||
SSL can only be used with versions of {{ destination.display_name }} that support TSL 1.2. Check which versions support it in [Microsoft's documentation]({{ site.data.destinations.microsoft-sql-server.resource-links.tls-support }}). | ||
{% endcapture %}s | ||
{% include note.html type="single-line" content=tsl-support-note %} | ||
Check the **{{ defaults.field-names.ssl }}** checkbox. {{ defaults.field-copy.ssl }} | ||
- title: "Save the destination" | ||
anchor: "save-destination" | ||
content: | | ||
{% include shared/database-connection-settings.html type="finish-up" %} | ||
--- | ||
{% include misc/data-files.html %} | ||
{% assign destination = page %} |
Oops, something went wrong.