diff --git a/_data/destinations/microsoft-sql-server/user-privileges.yml b/_data/destinations/microsoft-sql-server/user-privileges.yml index b0c34641d..5f20b128a 100644 --- a/_data/destinations/microsoft-sql-server/user-privileges.yml +++ b/_data/destinations/microsoft-sql-server/user-privileges.yml @@ -71,7 +71,7 @@ grant-permissions-to-user: &grant-permissions-sql | ## The individual steps for creating a Microsoft SQL Server user for Stitch. -microsoft-sql-server: +microsoft-sql-server: &mssql-steps - copy: "If you haven't already, connect to your {{ page.display_name }} instance using your SQL client." - copy: "Navigate to the `master` database." - copy: | @@ -83,4 +83,8 @@ microsoft-sql-server: command: *grant-control-sql - copy: | Run the following commands to allow the user to create tables and schemas: - command: *grant-permissions-sql \ No newline at end of file + command: *grant-permissions-sql + +amazon-rds-microsoft-sql-server: *mssql-steps +azure-sql-database: *mssql-steps +azure-sql-managed-instance: *mssql-steps diff --git a/_destinations/microsoft-sql-server/guides/connecting-amazon-rds-for-sql-server.md b/_destinations/microsoft-sql-server/guides/connecting-amazon-rds-for-sql-server.md new file mode 100644 index 000000000..46bef4e24 --- /dev/null +++ b/_destinations/microsoft-sql-server/guides/connecting-amazon-rds-for-sql-server.md @@ -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 %} \ No newline at end of file diff --git a/_destinations/microsoft-sql-server/guides/connecting-azure-sql-database.md b/_destinations/microsoft-sql-server/guides/connecting-azure-sql-database.md new file mode 100644 index 000000000..0ac4c8ef6 --- /dev/null +++ b/_destinations/microsoft-sql-server/guides/connecting-azure-sql-database.md @@ -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 %} \ No newline at end of file diff --git a/_destinations/microsoft-sql-server/guides/connecting-azure-sql-managed-instance.md b/_destinations/microsoft-sql-server/guides/connecting-azure-sql-managed-instance.md new file mode 100644 index 000000000..51b9d7162 --- /dev/null +++ b/_destinations/microsoft-sql-server/guides/connecting-azure-sql-managed-instance.md @@ -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 formatting & Controls # +# -------------------------- # + +title: Connecting an Azure SQL Managed Instance Destination to Stitch +permalink: /destinations/microsoft-sql-server/connecting-an-azure-sql-managed-instance-destination-to-stitch + +keywords: azure sql managed instance, azure sql managed instance data warehouse, azure sql managed instance data warehouse, azure sql managed instance etl, etl to azure sql managed instance, azure sql managed instance destination +summary: "Connect an Azure SQL Managed Instance destination to your Stitch account." + +content-type: "destination-setup" +key: "azure-sql-managed-instance-destination-setup" +order: 2 + +toc: true +layout: tutorial +use-tutorial-sidebar: false + + +# -------------------------- # +# Destination Details # +# -------------------------- # + +type: "microsoft-sql-server" +display_name: "Azure SQL Managed Instance" +name: "azure-sql-managed-instance" + +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/managed-instance/){: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 %} + + {% 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 %} \ No newline at end of file diff --git a/_destinations/microsoft-sql-server/guides/microsoft-sql-server-setup.md b/_destinations/microsoft-sql-server/guides/microsoft-sql-server-setup.md index 6cc2c2e81..10a08908d 100644 --- a/_destinations/microsoft-sql-server/guides/microsoft-sql-server-setup.md +++ b/_destinations/microsoft-sql-server/guides/microsoft-sql-server-setup.md @@ -15,7 +15,7 @@ title: Connecting a Microsoft SQL Server Destination to Stitch permalink: /destinations/microsoft-sql-server/connecting-a-microsoft-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 +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 summary: "Connect a Microsoft SQL Server destination to your Stitch account." content-type: "destination-setup"