Skip to content

Commit 776d916

Browse files
committed
Changes to the overall doc. Included paragraph about mappinng
1 parent 91e661e commit 776d916

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

docs/big-data-cluster/data-virtualization.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ One of the key scenarios for SQL Server 2019 CTP 2.0 is the ability to virtualiz
1515

1616
## Launch the virtualize data wizard
1717

18-
Connect to the master instance using the IP address / port number (31433) obtained at the end of the [deployment script](quickstart-big-data-cluster-deploy.md). Expand your **Databases** node in the Object Explorer and select one of the databases where you would like to virtualize the data into from an existing SQL Server instance. Right-click on the Database and select **Virtualize Data** from the context menu. This launches the Virtualize Data wizard. You can also launch the Virtualize Data wizard from the command palette by typing Ctrl+Shift+P (in Windows) and Cmd+Shift+P (in Mac).
18+
Connect to the target server's master instance using the IP address / port number (31433) obtained at the end of the [deployment script](quickstart-big-data-cluster-deploy.md). Expand your **Databases** node in the Object Explorer and select one of the databases where you would like to virtualize the data into from an existing SQL Server instance. Right-click on the Database and select **Virtualize Data** from the context menu. This launches the Virtualize Data wizard. You can also launch the Virtualize Data wizard from the command palette by typing Ctrl+Shift+P (in Windows) and Cmd+Shift+P (in Mac).
1919

2020
![Virtualize data wizard](media/virtualize-data/virtualize-data-wizard.png)
2121

@@ -29,24 +29,30 @@ Click Next to proceed to the next step in the wizard which sets the Database Mas
2929

3030
## Create database master key
3131

32-
In this step, we will let you create a database master key. Creating the master key is required as this secures the credentials used by an External Data Source. Please choose a strong password for your Master Key. You should also backup the master key by using BACKUP MASTER KEY and store the backup in a secure off-site location.
32+
In this step, you will be prompted to create a database master key. Creating the master key is required as this secures the credentials used by an External Data Source. Please choose a strong password for your Master Key. You should also backup the master key by using BACKUP MASTER KEY and store the backup in a secure off-site location.
3333

3434
![Create a database master key](media/virtualize-data/virtualize-data-master-key.png)
3535

3636
> [!IMPORTANT]
37-
> If you already have a database master key which is set up then the next time when you launch the wizard it will not prompt you to type in the master key anymore and you can click Next to proceed to the next page in the wizard.
37+
> If you already have a database master key the input fields will be restricted and you may bypass this step.You can just click "Next" to proceed to the next page in the wizard.
3838
3939
> [!NOTE]
4040
> If you don’t choose a strong password, then the wizard will in the last step. This is a known issue which we will fix in upcoming release so that it is more intuitive.
4141
4242
## Enter the external data source credentials
4343

44-
In this step, please enter your data source and credential details. This step creates an external data source object and then uses the credentials for the database object to connect to the data source. Provide a name of the External Data Source (example: Test) and provide the external data source SQL Server Connection details - the Server Name and the Database name where you want your external data source to be created on that server.
44+
In this step, please enter your external data source and the credential details. This step creates an external data source object and then uses the credentials for the database object to connect to the data source. Provide a name of the External Data Source (example: Test) and provide the external data source SQL Server Connection details - the Server Name and the Database name where you want your external data source to be created on that server.
4545

4646
The next step is to Configure Credential, so provide a Credential Name, this is the name of the Database scoped credential used to securely store the login information for the External Data Source you are creating (example: TestCred) and provide the username and password to connect to the data source.
4747

4848
![External data source credentials](media/virtualize-data/data-source-credentials.png)
4949

50+
## External Data Table Mapping
51+
52+
In the next window, you will be able to select the databases you want to create external views of. Note: Selecting the parent will include all child tables as well. When the tables are selected, the mapping of the external table can be seen on the right hand side. Here you can make any type changes or change the name of the external tables. Note: Double clicking a selected table will change the mapping view.
53+
54+
[IMPORTANT] Photo type is not yet supported by the data virtualization tool. Creating an external view with a photo type in it will throw an error after creation of table. The table will still be created though.
55+
5056
## Summary
5157

5258
This step provides a summary of your selections. It provides the name of the Database scoped credential and the External Data Source objects which will be created in the destination database. In this step, you have the option to **Generate Script** which will script out in T-SQL the syntax to create the external data source or **Create** which will create the External Data Source object.

0 commit comments

Comments
 (0)