Skip to content

Commit cc4bbcd

Browse files
20231204 topic type review, Related content fixes
1 parent 01e9a15 commit cc4bbcd

9 files changed

Lines changed: 101 additions & 93 deletions

docs/analytics-platform-system/pdw-and-appliance-fabric-physical-components.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Appliance physical components
3-
description: Names and descriptions for the PDW and appliance fabric physical components.
2+
title: Appliance physical components in Analytics Platform System (PDW)
3+
description: Names and descriptions for the Analytics Platform System (PDW) and appliance fabric physical components.
44
author: charlesfeddersen
55
ms.author: charlesf
66
ms.reviewer: martinle
@@ -10,7 +10,7 @@ ms.subservice: data-warehouse
1010
ms.topic: conceptual
1111
---
1212

13-
# Appliance physical components - Analytics Platform System
13+
# Appliance physical components - Analytics Platform System (PDW)
1414
Names and descriptions for the PDW and appliance fabric physical components.
1515

1616
<!-- MISSING LINKS See also [HDInsight Physical Components &#40;Analytics Platform System&#41;](hdinsight-physical-components.md). -->

docs/analytics-platform-system/pdw-certificate-provisioning.md

Lines changed: 26 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,25 @@ description: The PDW Certificate Provisioning page of the Analytics Platform Sys
44
author: charlesfeddersen
55
ms.author: charlesf
66
ms.reviewer: martinle
7-
ms.date: 04/17/2018
7+
ms.date: 12/04/2023
88
ms.service: sql
99
ms.subservice: data-warehouse
10-
ms.topic: conceptual
10+
ms.topic: how-to
1111
---
1212

13-
# PDW certificate provisioning - Analytics Platform System
13+
# PDW certificate provisioning - Analytics Platform System (PDW)
1414
The **PDW Certificate Provisioning** page of the Analytics Platform System **Configuration Manager** imports or removes the certificate used by the PDW region. Using, a certificate to encrypt connections can help secure communication to the Control node through SQL Server clients, tools that use the SQL Server PDW drivers, the [Admin Console](monitor-the-appliance-by-using-the-admin-console.md), and Integration Services loads.
15+
16+
Using, a certificate to encrypt connections can help secure communication to the Control node through SQL Server clients, tools that use the SQL Server PDW drivers, the [Admin Console](monitor-the-appliance-by-using-the-admin-console.md), and Integration Services loads.
1517

16-
## Prerequisites
18+
## Prerequisites
1719
Before installing the certificate, do the following:
1820

19-
1. Obtain a secure certificate. If you need more information about how to obtain a secure certificate, contact Microsoft Support.
21+
1. Obtain a secure certificate. If you need more information about how to obtain a secure certificate, contact Microsoft Support.
2022

21-
2. Save the certificate to the Control node in a password-protected PFX file.
23+
1. Save the certificate to the Control node in a password-protected PFX file.
2224

23-
## For Security Reasons, Obtain a Trusted Certificate
25+
## For security reasons, obtain a trusted certificate
2426
SQL Server PDW supports using a certificate to encrypt connections to the Control node; including connections to the **Admin Console**.
2527

2628
By default, the **Admin Console** includes a self-signed certificate that provides privacy, but not server authentication. This can leave communications vulnerable to a man-in-the-middle attack. When a user connects to the Admin Console by using the self-signed certificate, Internet Explorer returns the error: "There is a problem with this website's security certificate".
@@ -34,41 +36,41 @@ The certification path must contain the fully qualified domain name that maps to
3436

3537
Use the Analytics Platform System**Configuration Manager** to add or remove the trusted certificate. Directly using the Microsoft Windows HTTP Services Certificate Configuration Tool (**winHttpCertCfg.exe**) to manage the certificate is unsupported.
3638

37-
## Import or Remove the Certificate
39+
## Import or Remove the Certificate
3840
The following instructions show how to import or remove the appliance certificate.
3941

4042
> [!WARNING]
4143
> To renew an expired certificate you must remove the existing certificate BEFORE importing the new one.
4244
43-
### To import the certificate
45+
### <a id="to-import-the-certificate"></a> Import the certificate
4446

45-
1. Launch the **Configuration Manager**. For more information, see [Launch the Configuration Manager &#40;Analytics Platform System&#41;](launch-the-configuration-manager.md).
47+
1. Launch the **Configuration Manager**. For more information, see [Launch the Configuration Manager (Analytics Platform System)](launch-the-configuration-manager.md).
4648

47-
2. In the left pane of the **Configuration Manager**, expand **Parallel Data Warehouse Topology**, and then click **Certificates**.
49+
1. In the left pane of the **Configuration Manager**, expand **Parallel Data Warehouse Topology**, and then select **Certificates**.
4850

49-
3. Select **Import a certificate and configure the appliance to use it**, and then click **Browse** to browse to and select the certificate file.
51+
1. Select **Import a certificate and configure the appliance to use it**, and then select **Browse** to browse to and select the certificate file.
5052

51-
4. Enter the password for the certificate in the **Password** field.
53+
1. Enter the password for the certificate in the **Password** field.
5254

53-
5. Click **Apply** to configure the certificate for the appliance.
55+
1. Select **Apply** to configure the certificate for the appliance.
5456

5557
SQL Server PDW will not encrypt current connection by using the imported certificate, but will use the certificate for new connections.
5658

57-
### To remove the previously imported certificate
59+
### <a id="to-remove-the-previously-imported-certificate"></a> Remove the previously imported certificate
5860

59-
1. Launch the **Configuration Manager**. For more information, see [Launch the Configuration Manager &#40;Analytics Platform System&#41;](launch-the-configuration-manager.md).
61+
1. Launch the **Configuration Manager**. For more information, see [Launch the Configuration Manager (Analytics Platform System)](launch-the-configuration-manager.md).
6062

61-
2. In the left pane of the **Configuration Manager**, expand **Parallel Data Warehouse Topology**, and then click **Certificates**.
63+
1. In the left pane of the **Configuration Manager**, expand **Parallel Data Warehouse Topology**, and then select **Certificates**.
6264

63-
3. Select **Remove any certificate provisioned in the appliance**.
65+
1. Select **Remove any certificate provisioned in the appliance**.
6466

65-
4. Click **Apply** to remove the previously imported certificate from the appliance.
67+
1. Select **Apply** to remove the previously imported certificate from the appliance.
6668

6769
SQL Server PDW will continue to encrypt current connections, but will not use the removed certificate for new connections.
6870

69-
![DWConfig Appliance PDW Certificate](./media/pdw-certificate-provisioning/SQL_Server_PDW_DWConfig_ApplPDWCert.png "SQL_Server_PDW_DWConfig_ApplPDWCert")
70-
71-
## See Also
72-
[Launch the Configuration Manager &#40;Analytics Platform System&#41;](launch-the-configuration-manager.md)
73-
<!-- MISSING LINKS [HDInsight Certificate Provisioning &#40;Analytics Platform System&#41;](hdinsight-certificate-provisioning.md) -->
71+
:::image type="content" source="./media/pdw-certificate-provisioning/SQL_Server_PDW_DWConfig_ApplPDWCert.png" alt-text="A screenshot of the Microsoft Analytics Platform System Configuration Manager, showing the Certificates page.":::
7472

73+
## Related content
74+
75+
- [Launch the Configuration Manager in Analytics Platform System](launch-the-configuration-manager.md)
76+
- [HDInsight Certificate Provisioning (Analytics Platform System)](hdinsight-certificate-provisioning.md)

docs/analytics-platform-system/pdw-firewall-configuration.md

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -4,28 +4,28 @@ description: The firewall page of the SQL Server PDW Configuration Manager enabl
44
author: charlesfeddersen
55
ms.author: charlesf
66
ms.reviewer: martinle
7-
ms.date: 04/17/2018
7+
ms.date: 12/04/2023
88
ms.service: sql
99
ms.subservice: data-warehouse
10-
ms.topic: conceptual
10+
ms.topic: how-to
1111
---
12-
# Parallel Data Warehouse firewall configuration in Analytics Platform System
12+
# Parallel Data Warehouse firewall configuration in Analytics Platform System (PDW)
1313

1414
The **Firewall** page of the SQL Server PDW Configuration Manager enables you to enable or disable firewall rules that allow or prevent access to specific ports on the Analytics Platform System appliance.
1515

16-
## To manage ports and firewall rules for appliance nodes
16+
## <a id="to-manage-ports-and-firewall-rules-for-appliance-nodes"></a> Manage ports and firewall rules for appliance nodes
1717

18-
1. Launch the Configuration Manager. For more information, see [Launch the Configuration Manager &#40;Analytics Platform System&#41;](launch-the-configuration-manager.md).
18+
1. Launch the Configuration Manager. For more information, see [Launch the Configuration Manager (Analytics Platform System)](launch-the-configuration-manager.md).
1919

20-
2. In the left pane of the Configuration Manager, expand **Parallel Data Warehouse Topology**, and then click **Firewall**.
20+
1. In the left pane of the Configuration Manager, expand **Parallel Data Warehouse Topology**, and then select **Firewall**.
2121

22-
3. Locate the port or firewall rule to update in the configuration list, and then select or clear the box next to that item. Only SQL Server PDW admin-configurable options are shown in this list, including opening and closing ports on externally facing nodes.
22+
1. Locate the port or firewall rule to update in the configuration list, and then select or clear the box next to that item. Only SQL Server PDW admin-configurable options are shown in this list, including opening and closing ports on externally facing nodes.
2323

24-
4. Click **Apply** to save your changes.
24+
1. Select **Apply** to save your changes.
2525

26-
![DWConfig Appliance PDW Firewall](./media/pdw-firewall-configuration/SQL_Server_PDW_DWConfig_ApplPDWFirewall.png "SQL_Server_PDW_DWConfig_ApplPDWFirewall")
26+
:::image type="content" source="./media/pdw-firewall-configuration/SQL_Server_PDW_DWConfig_ApplPDWFirewall.png" alt-text="Screenshot of the Microsoft Analytics Platform System Configuration Manager, showing the Firewall page.":::
2727

28-
## External Ports
28+
## External Ports
2929
The following ports are opened for client connections coming from outside of PDW.
3030

3131
|Purpose|Port #|Nodes|
@@ -37,10 +37,10 @@ The following ports are opened for client connections coming from outside of PDW
3737
|dwloader BinaryLoaderDataChannel|16551|CMP|
3838
|SSL encrypted connections (For internal communications, to access the Admin Console)|443|All nodes|
3939
|SQL Server PDW Load Control Flow - Windows Credentials|8002|CTL|
40-
|_Kerberos|88|AD01 and AD02,|
40+
|_Kerberos|88|AD01 and AD02|
4141
|_ldap|389|AD01 and AD02|
4242

43-
## Internal Ports
43+
## Internal Ports
4444
The following ports are used by PDW for internal communication, but are not opened for connections coming from outside of the PDW appliance.
4545

4646
|Purpose|Port #|Nodes|
@@ -54,9 +54,13 @@ The following ports are used by PDW for internal communication, but are not open
5454
|SQL Server port ranges (TDS)|1433, 1500-1508|CTL, CMP|
5555

5656
> [!NOTE]
57-
> Creating external tables or external data sources uses TCP port 8020 by default. These statements can be configured to use other ports instead. The Hortonworks JOB_TRACKER_LOCATION default port is 50300. Integrating with other systems and tools may require additional ports.
57+
> Creating external tables or external data sources uses TCP port 8020 by default. These statements can be configured to use other ports instead. The Hortonworks JOB_TRACKER_LOCATION default port is 50300. Integrating with other systems and tools might require additional ports.
5858
5959
<!-- MISSING LINKS ## See Also
60-
[HDInsight Firewall Configuration &#40;Analytics Platform System&#41;](hdinsight-firewall-configuration.md)
60+
[HDInsight Firewall Configuration (Analytics Platform System)](hdinsight-firewall-configuration.md)
6161
-->
62-
62+
63+
## Related content
64+
65+
- [Topology of Analytics Platform System (PDW)](pdw-topology.md)
66+
- [PDW certificate provisioning - Analytics Platform System (PDW)](pdw-certificate-provisioning.md)

docs/analytics-platform-system/pdw-permissions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.subservice: data-warehouse
1010
ms.topic: conceptual
1111
---
1212

13-
# Managing permissions in Parallel Data Warehouse
13+
# Managing permissions in Analytics Platform System (PDW)
1414
This article describes the requirements and options for managing database permissions for SQL Server PDW.
1515

1616
## <a name="BackupRestoreBasics"></a>Database Engine Permission Basics
Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,31 @@
11
---
2-
title: PDW services status
3-
description: Parallel Data Warehouse (PDW) services status for Analytics Platform System.
2+
title: Analytics Platform System (PDW) services status
3+
description: Analytics Platform System (PDW) services status for Analytics Platform System.
44
author: charlesfeddersen
55
ms.author: charlesf
66
ms.reviewer: martinle
7-
ms.date: 04/17/2018
7+
ms.date: 12/04/2023
88
ms.service: sql
99
ms.subservice: data-warehouse
10-
ms.topic: conceptual
10+
ms.topic: how-to
1111
---
1212

13-
# Parallel Data Warehouse services status for Analytics Platform System
14-
The Parallel Data Warehouse **Services Status** page in the Microsoft Analytics Platform System Configuration Manager shows the current status of all SQL Server PDW services, and provides the ability to stop and start the PDW services. This is the only supported method for starting and stopping the PDW services. Note that individual components or services cannot be started independently.
13+
# Parallel Data Warehouse services status for Analytics Platform System (PDW)
14+
The Parallel Data Warehouse **Services Status** page in the Microsoft Analytics Platform System Configuration Manager shows the current status of all SQL Server PDW services, and provides the ability to stop and start the PDW services. This is the only supported method for starting and stopping the PDW services. Individual components or services cannot be started independently.
1515

16-
#### To start or stop the appliance services
16+
#### <a id="to-start-or-stop-the-appliance-services"></a> Start or stop the appliance services
1717

18-
1. To start the appliance services, click **Start Appliance**.
18+
1. To start the appliance services, select **Start Appliance**.
1919

20-
2. To stop the appliance services, click **Stop Appliance**.
20+
1. To stop the appliance services, select **Stop Appliance**.
2121

22-
It is not necessary to click **Apply** when starting and stopping the appliance services by using **Start Appliance** and **Stop Appliance**.
22+
It is not necessary to select **Apply** when starting and stopping the appliance services by using **Start Appliance** and **Stop Appliance**.
2323

24-
![DWConfig Appliance PDW Services](./media/pdw-services-status/SQL_Server_PDW_DWConfig_ApplPDWServices.png "SQL_Server_PDW_DWConfig_ApplPDWServices")
24+
:::image type="content" source="./media/pdw-services-status/SQL_Server_PDW_DWConfig_ApplPDWServices.png" alt-text="A screenshot of the Microsoft Analytics Platform System Configuration Manager, showing the Services Status page.":::
2525

2626
> [!NOTE]
2727
> Stopping the PDW Region also stops the PDW agent (sqldwagent) on the nodes. The PDW agent requires the PDW control node to report health monitoring.
2828
29-
## See Also
30-
[Power the APS Appliance On or Off &#40;Analytics Platform System&#41;](power-the-aps-appliance-on-or-off.md)
31-
29+
## Related content
30+
31+
- [Power the appliance on or off for Analytics Platform System](power-the-aps-appliance-on-or-off.md)

docs/analytics-platform-system/pdw-topology.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,17 +4,17 @@ description: PDW topology for Analytics Platform System.
44
author: charlesfeddersen
55
ms.author: charlesf
66
ms.reviewer: martinle
7-
ms.date: 04/17/2018
7+
ms.date: 12/04/2023
88
ms.service: sql
99
ms.subservice: data-warehouse
1010
ms.topic: conceptual
1111
---
1212

13-
# PDW Topology
13+
# Topology of Analytics Platform System (PDW)
1414
Displays name and network information about the SQL Server PDW components. Use the **Appliance Topology Network Configuration** page to change the network IP Addresses.
1515

16-
![DWConfig PDW top menu](./media/pdw-topology/SQL_Server_PDW_DWConfig_PDWTop.png "SQL_Server_PDW_DWConfig_PDWTop")
17-
18-
## See Also
19-
[Launch the Configuration Manager &#40;Analytics Platform System&#41;](launch-the-configuration-manager.md)
20-
16+
:::image type="content" source="./media/pdw-topology/SQL_Server_PDW_DWConfig_PDWTop.png" alt-text="Screenshot of the Microsoft Analytics Platform System Configuration Manager, showing the Parallel Data Warehouse topology page.":::
17+
18+
## Related content
19+
20+
- [Launch the Configuration Manager in Analytics Platform System](launch-the-configuration-manager.md)

docs/analytics-platform-system/polybase-configure-azure-blob-storage.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ description: Explains how to use PolyBase on a Parallel Data Warehouse (APS) to
44
author: charlesfeddersen
55
ms.author: charlesf
66
ms.reviewer: martinle
7-
ms.date: 04/17/2018
7+
ms.date: 12/04/2023
88
ms.service: sql
99
ms.subservice: data-warehouse
10-
ms.topic: conceptual
10+
ms.topic: how-to
1111
---
1212
# Configure PolyBase to access external data in Azure Blob Storage
1313

@@ -38,7 +38,7 @@ First, configure APS to use Azure Blob Storage.
3838
GO
3939
```
4040

41-
2. Restart APS Region using Service Status page on [Appliance Configuration Manager](launch-the-configuration-manager.md).
41+
1. Restart APS Region using Service Status page on [Appliance Configuration Manager](launch-the-configuration-manager.md).
4242

4343
## Configure an external table
4444

@@ -115,7 +115,7 @@ There are three functions that PolyBase is suited for:
115115

116116
The following queries provide example with fictional car sensor data.
117117

118-
### Ad hoc queries
118+
### Ad hoc queries
119119

120120
The following ad hoc query joins relational with data in Azure Blob Storage. It selects customers who drive faster than 35 mph, joining structured customer data stored in SQL Server with car sensor data stored in Azure Blob Storage.
121121

@@ -127,7 +127,7 @@ WHERE Insured_Customers.CustomerKey = CarSensor_Data.CustomerKey and CarSensor_D
127127
ORDER BY CarSensor_Data.Speed DESC
128128
```
129129

130-
### Importing data
130+
### <a id="importing-data"></a> Import data
131131

132132
The following query imports external data into APS. This example imports data for fast drivers into APS to do more in-depth analysis. To improve performance, it leverages Columnstore technology in APS.
133133

@@ -146,7 +146,7 @@ from Insured_Customers INNER JOIN
146146
ON Insured_Customers.CustomerKey = SensorD.CustomerKey
147147
```
148148

149-
### Exporting data
149+
### <a id="exporting-data"></a> Export data
150150

151151
The following query exports data from APS to Azure Blob Storage. It can be used to archive relational data to Azure Blob Storage while still be able to query it.
152152

@@ -164,13 +164,13 @@ ON (T1.CustomerKey = T2.CustomerKey)
164164
WHERE T2.YearMeasured = 2009 and T2.Speed > 40;
165165
```
166166

167-
## View PolyBase objects in SSDT
167+
## View PolyBase objects in SSDT
168168

169-
In SQL Server Data Tools, external tables are displayed in a separate folder **External Tables**. External data sources and external file formats are in subfolders under **External Resources**.
169+
In SQL Server Data Tools (SSDT), external tables are displayed in a separate folder **External Tables**. External data sources and external file formats are in subfolders under **External Resources**.
170170

171-
![PolyBase objects in SSDT](media/polybase/external-tables-datasource.png)
171+
:::image type="content" source="media/polybase/external-tables-datasource.png" alt-text="A screenshot of PolyBase objects in the object explorer of SSDT.":::
172172

173-
## Next steps
174-
175-
For more information about PolyBase, see the [What is PolyBase?](../relational-databases/polybase/polybase-guide.md).
173+
## Next step
176174

175+
> [!div class="nextstepaction"]
176+
> [Introducing data virtualization with PolyBase](../relational-databases/polybase/polybase-guide.md)

0 commit comments

Comments
 (0)