review-2

Author: v-thpra

learn-pr/sqlserver/introduction-sql-server-linux/4-tools-sql-server-linux.yml

@@ -3,7 +3,7 @@ uid: learn-sqlserver.introduction-sql-server-linux.4-tools-sql-server-linux
 title: Tools for SQL Server on Linux
 metadata:
   title: Tools for SQL Server on Linux
-  description: In this unit, you will learn about the tools and software packages that you need to administer SQL Server on Linux.
+  description: In this unit, you learn about the tools and software packages that you need to administer SQL Server on Linux.
   ms.date: 04/25/2023
   author: rwestmsft
   ms.author: randolphwest
@@ -16,7 +16,7 @@ content: |
 quiz:
   title: Check your knowledge
   questions:
-  - content: "To make sure that you're complying with legislation, you want to discover what Personally Identifiable Information you have in your database. Which tool should you be using?"
+  - content: "To make sure that you're complying with legislation, you want to discover what personal data you have in your database. Which tool should you be using?"
     choices:
     - content: "Azure Data Studio"
       isCorrect: false
@@ -29,12 +29,12 @@ quiz:
       explanation: "To discover specific data, use Data Discovery and Classification. This tool is only available in SSMS."
   - content: "Which command-line tool should be recommended if a user wants to write Transact-SQL in a rich multi-line editor with syntax highlighting?"
     choices:
-    - content: mssql-conf
+    - content: "mssql-conf"
       isCorrect: false
       explanation: "mssql-conf is used for configuring SQL Server on Linux. It has no ability to write Transact-SQL."
-    - content: mssql-cli
+    - content: "mssql-cli"
       isCorrect: true
       explanation: "mssql-cli provides Transact-SQL IntelliSense syntax highlighting, pretty formatting for query results, and a multi-line edit mode."
-    - content: mssql-tools
+    - content: "mssql-tools"
       isCorrect: false
       explanation: "mssql-tools is a package that makes bcp and sqlcmd available to Linux."

learn-pr/sqlserver/introduction-sql-server-linux/5-containers.yml

@@ -16,14 +16,14 @@ content: |
 quiz:
   title: Check your knowledge
   questions:
-  - content: "When would a VM be the best choice to host an application?"
+  - content: "When would a virtual machine (VM) be the best choice to host an application?"
     choices:
-    - content: "If the app needs to be hosted without modification on different operating systems"
+    - content: "When the app needs to be hosted without modification on different operating systems."
       isCorrect: true
-      explanation: "It's possible to host a VM on operating systems."
-    - content: "If the app needs to scale quickly and be fault tolerant"
+      explanation: "It's possible to host a VM on different operating systems."
+    - content: "When the app must be fault tolerant and scale quickly."
       isCorrect: false
-      explanation: "VMs must be shut down to scale them, and in themselves are not automatically fault tolerant."
-    - content: "If the app is small and self-contained"
+      explanation: "VMs must be shut down to scale them, and in themselves aren't automatically fault tolerant."
+    - content: "When the app is small and self-contained"
       isCorrect: false
       explanation: "Small, simple apps that are self-contained are ideal candidates for use in containers."

learn-pr/sqlserver/introduction-sql-server-linux/6-summary.yml

@@ -3,7 +3,7 @@ uid: learn-sqlserver.introduction-sql-server-linux.6-summary
 title: Summary
 metadata:
   title: Summary
-  description: In this unit, you will review what you have learned about SQL Server on Linux.
+  description: In this unit, you review what you learned about SQL Server on Linux.
   ms.date: 04/25/2023
   author: rwestmsft
   ms.author: randolphwest

learn-pr/sqlserver/introduction-sql-server-linux/includes/2-what-sql-server-linux.md

@@ -26,7 +26,7 @@ Wide World Importers has databases in Oracle and SAP HANA in addition to SQL Ser
 
 ## Shared codebase
 
-On both Linux and Windows, SQL Server uses the SQL Platform Abstraction Layer (SQLPAL), which allows SQL Server to run on all the supported operating systems. Therefore, developers can write applications using their favorite language (such as .NET, PHP, node.JS, Java, or Python) and expect the application to run the same way anywhere, whether they're using SQL Server running on Windows, Linux, Linux containers, Azure SQL Edge, or Azure SQL Database.
+On both Linux and Windows, SQL Server uses the SQL Platform Abstraction Layer (SQLPAL), which allows SQL Server to run on all the supported operating systems. Therefore, developers can write applications using their favorite language (such as .NET, PHP, node.JS, Java, or Python). They can also expect the application to run the same way anywhere, whether they're using SQL Server running on Windows, Linux, Linux containers, Azure SQL Edge, or Azure SQL Database.
 
 ## Containers
 

learn-pr/sqlserver/introduction-sql-server-linux/includes/3-sql-server-linux-features.md

@@ -80,7 +80,7 @@ ALTER DATABASE <database_name> SET COMPATIBILITY_LEVEL = 160;
 
 SQL Server on Linux supports advanced security features such as Always Encrypted, row-level security and dynamic data masking to protect data on disk, in memory, or in transit. These features are all supported in all editions, including Standard Edition:
 
-- **Transparent Data Encryption (TDE)** encrypts data-at-rest when it's stored in database files. The data is protected against malicious users both in the database and in backups.
+- **Transparent Data Encryption (TDE)** encrypts data-at-rest when the data is stored in database files. The data is protected against malicious users both in the database and in backups.
 
 - **Always Encrypted** ensures that only users who own data can view and process it. Users who manage data, like the database administrators, can't view it. If you use Always Encrypted:
 
@@ -97,7 +97,7 @@ SQL Server on Linux supports advanced security features such as Always Encrypted
 
 - **Data Discovery and Classification** identifies, labels, and reports on the sensitive data in your databases, such as personal data. It's a tool within SQL Server Management Studio (SSMS) that makes it easier to comply with data privacy legislation and harden the databases that contain the most valuable data. Data Discovery and Classification is a service that is part of the Advanced Data Security (ADS) package.
 
-- **Vulnerability Assessment** identifies vulnerabilities in your databases. Once you're aware of the weaknesses that your server configuration and database designs might cause, you can mitigate them and prevent common attacks. Vulnerability Assessment is another ADS service.
+- **Vulnerability Assessment** identifies vulnerabilities in your databases. Once you're aware of the weaknesses that your server configuration and database designs might cause, you can prevent common attacks by mitigating them. Vulnerability Assessment is another ADS service.
 
 ## SQL Server Agent
 
@@ -118,17 +118,17 @@ sudo systemctl restart mssql-server
 
 SQL Server has many ways to specify the level of fault tolerance that's acceptable. SQL Server on Linux supports Always On availability groups and Always On failover cluster instances. Both of these options require the `mssql-server-ha` package installed on each server. Linux supports clustering via **Pacemaker**, which is an equivalent to Windows Server Failover Clustering (WSCF), albeit not as tightly integrated into the host operating system.
 
-If there's more flexibility in what's acceptable for downtime, Log Shipping via SQL Agent can provide warm standbys, which you use to recover from server loss.
+If there's more flexibility in what's acceptable for downtime, Log Shipping via SQL Agent can provide a warm standby, which you use to recover from server loss.
 
 Another solution for SQL Server on Linux is its ability to run in containers orchestrated with tools such as Kubernetes. Orchestration tools ensure there's always a node running SQL Server. If that node fails, another instance is bootstrapped automatically. When more robust availability is required, an Always On availability group can be run in containers.
 
 ## Other notable features
 
 ### PolyBase
 
-Many organizations have data in different systems. That might be because different teams had different requirements when they selected their system, because you merged with another company, or for some other historical reason. Traditionally, it's been difficult to integrate data across these system boundaries to answer questions for users.
+Many organizations have data in different systems. Perhaps, different teams had different requirements when they selected their system, or the company merged with another company, or for some other historical reason. Traditionally, it's difficult to integrate data across these system boundaries to answer questions for users.
 
-Suppose you have data in SQL Server that records sales for your product catalog, but the data that records how much it costs to make your products is in an SAP HANA database. You want to create a report that analyzes profit margins. You'll need information from both databases. In the past, you could:
+Suppose you have data in SQL Server that records sales for your product catalog, but the data that records how much it costs to make your products, is in an SAP HANA database. You want to create a report that analyzes profit margins, so you need information from both databases. In the past, you could:
 
 - Use an Extract, Transform, Load (ETL) package to migrate data from one database system to the other.
 - Query both databases and then write some custom code to join and integrate the results into a single report.
@@ -142,7 +142,7 @@ With PolyBase, you can create an external table in SQL Server. An external table
 
 ### Machine Learning Services
 
-In machine learning, large datasets are used to model the behavior of some complex system. When a model has been developed that accurately predicts the observed behavior of the system, it's used to predict how that system might behave in the future. Sophisticated libraries of code, often open-source, have been developed that can prepare your dataset, add features to it, train a model, evaluate the accuracy of the trained model, and deploy those models for other clients to call. These libraries are written in the R and Python languages.
+In machine learning, large datasets are used to model the behavior of some complex system. When a model is developed that accurately predicts the observed behavior of the system. The model is used to predict how that system might behave in the future. Sophisticated code libraries, often open-source, were developed in the R and Python languages. These libraries can prepare your dataset, add features to it, train a model, evaluate the accuracy of the trained model, and deploy those models for other clients to call.
 
 SQL Server Machine Learning Services allows you to run these R and Python scripts against the data in your SQL Server databases. You can add the popular machine learning and data science frameworks, including PyTorch, TensorFlow, SciKit-Learn, and others.
 
@@ -155,7 +155,7 @@ SQL Server has native support for storing and querying graph-based data. SQL Ser
 
 ### Full-text search
 
-Full-text searches allow users to run queries against text data that respect linguist rules. For example, when you search for the word `run`, a full-text search returns results that include forms of the word `run`, such as `ran` and `running`.
+Full-text searches allow users to run queries against text data that respect linguist rules. For example, when you search for the word `run`, a full-text search returns a result that includes forms of the word `run`, such as `ran` and `running`.
 
 This feature isn't installed by default. On Linux, you enable it by installing the `mssql-server-fts` package.
 

learn-pr/sqlserver/introduction-sql-server-linux/includes/4-tools-sql-server-linux.md

@@ -1,39 +1,41 @@
-When an organization runs SQL Server on Windows servers, the principal administration tool is SQL Server Management Studio (SSMS). This tool doesn't run on Linux, although you can connect it to a Linux SQL Server from Windows computer. 
+When an organization runs SQL Server on Windows servers, the principal administration tool is SQL Server Management Studio (SSMS). This tool doesn't run on Linux, although you can connect it to a Linux SQL Server from a Windows computer.
 
 For the Wide World Importers database migration, you want to learn how a Linux administrator configures, queries, and maintains SQL Server. Your Linux servers don't run graphical user interfaces (GUIs) and provide only a command-line shell, but you also have Linux laptops with GUIs. You want to find out about tools you can use to administer SQL Server, both from the command line and from the Linux laptops.
 
-Here, you'll learn about the administration tools you can execute on Linux.
+Here, you learn about the administration tools you can execute on Linux.
 
 ## Native Linux tools
 
 Database administrators use many native Linux tools with which you're already familiar from other administration tasks.
 
 Software installation and upgrades are done using **apt**, **zypper**, or **yum**, depending on the Linux distribution.
 
-After SQL Server is installed, it runs as a Linux service, so you can use **systemd** to start, stop, or restart the database server. This also means that, if you want to set up highly available clusters of SQL Server instances, you can use **Pacemaker** to do it.
+After SQL Server is installed, it runs as a Linux service, so you can use **systemd** to start, stop, or restart the database server. Also, it means that if you want to set up highly available clusters of SQL Server instances, you can use **Pacemaker** to do it.
 
-> [!NOTE]
+> [!NOTE]  
 > Linux POSIX file paths have support in both the graphical tools and Transact-SQL statements. <!-- this seems in the wrong place -->
 
 ## SQL Server administration tools
 
-For database tasks such as configuration, schema creation, data population, and user management, you use tools that are specifically written to work with SQL Server.
+For database tasks such as configuration, schema creation, data population, and user management, you use tools that are written specifically to work with SQL Server.
 
-Remember that, if you have a Windows computer with SSMS installed on it, you can connect it to SQL Servers that run on Linux and administer them as you would any other SQL Server. Administrators in mixed Windows and Linux environments might prefer to work this way.
+If you have a Windows computer with SSMS installed on it, you can connect it to SQL Servers that run on Linux and administer them as you would any other SQL Server. Administrators in mixed Windows and Linux environments might prefer to work this way.
 
 If you want to administer SQL Server from a Linux computer, then your choice of tool depends on whether you're running a GUI.
 
 ### Azure Data Studio
 
 Azure Data Studio is a free, graphical, cross-platform SQL Server administration and development application that runs on Linux, Windows, or Mac. You can run this tool on any Linux client or server that includes an X Windows GUI. The core functionality is limited, but you can expand it by adding extensions created by Microsoft or third-party authors.
 
-> [!NOTE]
+> [!NOTE]  
 > Azure Data Studio is powerful and flexible, but doesn't include some of the advanced features found in SSMS. For example, the Data Discovery and Classification tool and the Vulnerability Assessment tool, which you learned about in the last unit, are only available in SSMS.
 
 ## SQL Server command-line tools
 
-Microsoft provides a set of command-line tools you can use to administer and develop databases on SQL Server on Linux. You can use these on any Linux machine, even those without a GUI:
+Microsoft provides a set of command-line tools you can use to administer and develop databases on SQL Server on Linux. You can use these command-line tools on any Linux machine, even machines without a GUI:
 
 - **mssql-cli** provides Transact-SQL IntelliSense syntax highlighting, formatted query results, and a multi-line edit mode.
+
 - **mssql-conf** is a set of scripts that you run after installation, and later, to configure SQL Server on Linux. For example, you use these scripts to enable SQL Server Agent, or set up a High Availability Group.
-- **mssql-tools** is a package that contains **sqlcmd** and **bcp** commands, which have the same functions as on Windows.
+
+- **mssql-tools** is a package that contains the `sqlcmd` and `bcp` commands, which have the same functions as on Windows.