数据库管理 API 是一个 REST API。所发送的操作请求通过 SSL 进行加密，并使用 X.509 证书对其进行身份验证。可以通过 Internet 从可以发送 HTTPS 请求和接收 HTTPS 响应的任何应用程序发出这些请求。请求将发送到使用以下基本 URL 的端口 8443 上的 SQL Database 数据库管理服务：https://management.database.windows.net:8443

这个blog介绍了以编程方式 (使用 Visual Studio 2012 RC 中的 HttpClient) 创建一个Windows Azure SQL 数据库服务器，设置管理密码，并创建防火墙规则。我们可以使用如下步骤：

1. 准备访问数据库管理 API 的客户端证书。
2. 设置相应的HTTP请求标头，如版本号等。
3. 创建数据库服务器
1. 定义请求数据的 .net 对象
2. 发送请求，并接收服务器响应数据
3. 将响应数据转换为 .net (如C#) 的相应对象
4. 从对象中读取信息
4. 设置管理密码
5. 创建防火墙规则
6. 连接到新创建的数据库服务器

1、准备客户端证书

数据库管理 API 需要基于证书的相互身份验证。我们需要首先将公钥证书（.cer）文件与订阅相关联，方法是使用 Windows Azure 平台管理门户将该证书上载到 Windows Azure 中订阅的证书存储区。然后，将匹配的私钥证书（.pfx）文件附加到数据库管理 API 请求中。

有关证书创建，可以参考 如何创建管理证书 以及 如何为角色创建证书。例如，可以使用MakeCert工具，具体命令可参考 Step 1 - Create and Install a test certificate 。

进而我们可以获得 .cer 文件（包含公钥） 和 .pfx 文件 （包含私钥和公钥，私钥保护密码由用户指定），可以使用管理门户将公钥证书 （.cer 文件）上载到 Windows Azure中订阅的证书存储区，如：

之后，可以使用 System.Net.Http.WebRequestHandler 和 System.Security.Cryptography.X509Certificate2 .NET 类将私钥 (.pfx) 文件与安全请求相关联。

如以下代码片段，其中参数certFilename 和certPassword 分别是 .pfx 文件的全路径文件名和私钥保护密码 （私钥和密码不与请求一起发送；它们仅用于对请求进行验证）：

WebRequestHandler webRequestHandler = new WebRequestHandler();
 webRequestHandler.ClientCertificateOptions = ClientCertificateOption.Manual;
 webRequestHandler.ClientCertificates.Add(
 new X509Certificate2(certFilename, certPassword));

2、设置相应的HTTP请求标头

HttpClient可用于发送 Http 请求，并用于接收 Http 响应。如下代码片段生成一个HttpClient实例，并设置访问 API 的版本信息：

this.httpClient = new HttpClient(webRequestHandler);
this.httpClient.DefaultRequestHeaders.Add("x-ms-version", "1.0");

完整代码片段如下：

public class SqlRestApiClient
{
 private const string ServerUri = "https://management.database.windows.net:8443/{0}/servers";
 private const string FirewallUri = ServerUri + "/{1}/firewallrules";
 private readonly string subscriptionId;
 private readonly HttpClient httpClient;
 private readonly XmlMediaTypeFormatter xmlFormatter;
 private readonly IEnumerable<XmlMediaTypeFormatter> xmlFormatters;
 
 public SqlRestApiClient(string certFilename, string certPassword, string subscriptionId)
 {
 WebRequestHandler webRequestHandler = new WebRequestHandler();
 webRequestHandler.ClientCertificateOptions = ClientCertificateOption.Manual;
 webRequestHandler.ClientCertificates.Add(
 new X509Certificate2(certFilename, certPassword));
 
 this.httpClient = new HttpClient(webRequestHandler);
 this.httpClient.DefaultRequestHeaders.Add("x-ms-version", "1.0");
 
 this.xmlFormatter = new XmlMediaTypeFormatter()
 {
 UseXmlSerializer = true,
 };
 this.xmlFormatters = new XmlMediaTypeFormatter[] { xmlFormatter };
 this.subscriptionId = subscriptionId;
 }
}

3、创建数据库服务器

定义请求数据的 .net 对象

定义请求数据 .Net 对象 ServerRequest如下：

 [XmlRoot(ElementName = "Server",
 Namespace = "http://schemas.microsoft.com/sqlazure/2010/12/")]
 public class ServerRequest
 {
 public string AdministratorLogin { get; set; }
 public string AdministratorLoginPassword { get; set; }
 public string Location { get; set; }
 }

发送请求并接收服务器响应数据

设置枚举服务器的url，其中需要指定 Windows Azure 的订阅ID （参数：subscriptionId）；构建请求数据：

 string url = string.Format(ServerUri, this.subscriptionId);
 var request = new ServerRequest()
 {
 AdministratorLogin = adminName,
 AdministratorLoginPassword = adminPwd,
 Location = location,
 };

设置Xml媒体类型序列化器，然后发送HTTP POST请求，并读取响应正文。

 HttpResponseMessage response = await this.httpClient
 .PostAsync<ServerRequest>(url, request, this.xmlFormatter);

将响应数据转换为 .net (如C#) 的相应对象

我们可以定义 .net 对象ServerName如下：

 [XmlRoot(ElementName = "ServerName",
 Namespace = "http://schemas.microsoft.com/sqlazure/2010/12/")]
 public class CreateServerResponse
 {
 [XmlText]
 public string ServerName { get; set; } 
 }

将响应正文数据转换为 C# 对象：

 CreateServerResponse server = await response.Content
 .ReadAsAsync<CreateServerResponse>(this.xmlFormatters);

从对象中读取信息

例如我们可以读取 server.ServerName 信息，如下：

 Console.WriteLine("ServerName: {0}", server.ServerName);

创建SQL数据库服务器的完整代码片段如下：

 async public Task CreateServer(string adminName, string adminPwd, string location)
 {
 string url = string.Format(ServerUri, this.subscriptionId);
 var request = new ServerRequest()
 {
 AdministratorLogin = adminName,
 AdministratorLoginPassword = adminPwd,
 Location = location,
 };
 
 HttpResponseMessage response = await this.httpClient
 .PostAsync<ServerRequest>(url, request, this.xmlFormatter);
 
 if (!response.IsSuccessStatusCode)
 {
 this.ErrorHandler(response);
 return;
 }
 
 CreateServerResponse server = await response.Content
 .ReadAsAsync<CreateServerResponse>(this.xmlFormatters);
 
 Console.WriteLine("ServerName: {0}", server.ServerName);
 }
 
 private async void ErrorHandler(HttpResponseMessage response)
 {
 Console.WriteLine("Caught HttpResponseException");
 Error error = await response.Content
 .ReadAsAsync<Error>(this.xmlFormatters);
 Console.WriteLine(
 "Code: {0}, Message: {1}, Severity: {2}, State: {3}",
 error.Code,
 error.Message,
 error.Severity,
 error.State);
 }

其中Error定义如下：

 [XmlRoot(Namespace = "http://schemas.microsoft.com/sqlazure/2010/12/")]
 public class Error
 {
 public uint Code { get; set; }
 public string Message { get; set; }
 public uint Severity { get; set; }
 public uint State { get; set; }
 }

调用方式如下：

 SqlRestApiClient sqlRestApiClient = new SqlRestApiClient(
 "windows_azure_tools.pfx",
 "certPassword",
 "c4a83956-af86-4606-8881-d12c0ae12ea6");
 await sqlRestApiClient.CreateServer("adm1", "Pa$$word123$$", "North Central US"); 

例如，输出如下：

ServerName: ux5zdppgom

也可以登录Windows Azure管理门户查看新创建的SQL数据库服务器：

4、设置管理密码

在前面创建SQL数据库服务器时我们设置了管理员帐户名称和密码，过后我们可使用“设置服务器管理员密码” REST API重新设置 SQL 数据库服务器的管理密码。

我们可以定义重置密码请求的对象如下：

 [XmlRoot(ElementName = "AdministratorLoginPassword",
 Namespace = "http://schemas.microsoft.com/sqlazure/2010/12/")]
 public class AdministratorLoginPasswordRequest
 {
 [XmlText]
 public string AdministratorLoginPassword { get; set; }
 }

重置密码方法如创建SQL服务器类似。先设定请求的Url，创建请求消息，然后发送请求，接收响应数据。

设置管理密码的代码片段如下：

 async public Task ResetPassword(string serverName, string password)
 {
 string url = string.Format(ServerUri + "/{1}?op=ResetPassword",
 this.subscriptionId,
 serverName);
 var request = new AdministratorLoginPasswordRequest()
 {
 AdministratorLoginPassword = password,
 };
 
 HttpResponseMessage response = await this.httpClient
 .PostAsync(url, request, this.xmlFormatter);
 
 if (response.IsSuccessStatusCode)
 {
 Console.WriteLine(
 "server: {0}, password {1} is reset successfully",
 serverName,
 password);
 }
 else
 {
 this.ErrorHandler(response);
 }
 }

调用方式如下：

await sqlRestApiClient.ResetPassword("ux5zdppgom", "Pa$word123$");

输出如下：

server: ux5zdppgom, password Pa$word123$ is reset successfully

5、创建防火墙规则

为服务器创建防火墙规则

默认情况下，新创建的SQL服务器禁止来自客户端的访问。我们可以为服务器创建防火墙规则，以允许来之客户端，或/和允许从与 Windows Azure 相关的应用程序和服务连接到服务器。

防火墙规则对象可定义如下：

[XmlRoot(ElementName = "FirewallRule",
 Namespace = "http://schemas.microsoft.com/sqlazure/2010/12/")]
 public class FirewallRuleRequest
 {
 public string StartIpAddress { get; set; }
 public string EndIpAddress { get; set; }
 }

使用类似设置管理密码的流程，一个不同之处是：我们需要发送HTTP PUT请求，而不是POST请求。代码片段如下：

async public Task CreateFirewallRule(string serverName, string ruleName, string startIp, string endIp)
 {
 string url = string.Format(FirewallUri + "/{2}",
 this.subscriptionId,
 serverName,
 ruleName);
 var request = new FirewallRuleRequest()
 {
 StartIpAddress = startIp,
 EndIpAddress = endIp,
 };
 
 HttpResponseMessage response = await this.httpClient
 .PutAsync(url, request, this.xmlFormatter);
 
 if (response.IsSuccessStatusCode)
 {
 Console.WriteLine("rule: {0} [{1} - {2}] written successfully",
 ruleName,
 startIp,
 endIp);
 }
 else
 {
 this.ErrorHandler(response);
 }
 }

调用方式如下：

await sqlRestApiClient.CreateFirewallRule("ux5zdppgom", "rule1", "0.0.0.0", "0.0.0.0");

输出如下：

rule: rule1 [0.0.0.0 - 0.0.0.0] written successfully

其中起始和结束 IP 地址设置为 0.0.0.0 的防火墙规则允许从与 Windows Azure 相关的应用程序和服务连接到服务器。

使用 IP 检测为服务器创建防火墙规则

我们还可以使用 IP 检测为服务器创建防火墙规则。当用户由于地址转换、代理服务器等原因不知道自己的外部 IP 地址时，这可能会有用。方法与如上类似，先定义一个IpAddress对象：

[XmlRoot(ElementName = "IpAddress",
 
 Namespace = "http://schemas.microsoft.com/sqlazure/2010/12/")]
 public class IpAddressResponse
 {
 [XmlText]
 public string IpAddress { get; set; }
 }

代码如下：

async public Task CreateFirewallRuleWithClientIp(string serverName, string ruleName)
 
 {
 string url = string.Format(FirewallUri + "/{2}?op=AutoDetectClientIP",
 this.subscriptionId,
 serverName,
 ruleName);
 
 var requestMessage = new HttpRequestMessage();
 HttpResponseMessage response = await this.httpClient
 .PostAsync(url, requestMessage.Content);
 
 if (!response.IsSuccessStatusCode)
 {
 this.ErrorHandler(response);
 return;
 }
 
 IpAddressResponse ip = await response.Content
 .ReadAsAsync<IpAddressResponse>(this.xmlFormatters);
 
 Console.WriteLine("rule: {0} added with client ip: {1}",
 ruleName,
 ip.IpAddress);
 }

调用方式可以为：

await sqlRestApiClient.CreateFirewallRuleWithClientIp("ux5zdppgom", "rule2");

输出如下：

rule: rule2 added with client ip: 116.96.128.226

6、连接到新创建的数据库服务器

我们可以使用SQL Server Management Studio (SSMS) 连接到如上新创建的SQL数据库服务器。

输入服务器名称，验证方式选择为：SQL Server Authentication，然后输入用户名和密码。

点击连接，连接成功后我们可以看到：

有关SQL Database 数据库管理 API的更多信息，可以参考msdn中相应内容 。

软件开发工程师  苏从勇

AccessSqlRestApi.zip

在Object Explorer里右键点击前文创建的blogtest session，选择Watch Live Data，如图1所示，这将在SSMS里打开一个新的Live Data窗口，这时我们可以执行我们的workload，workload可以是应用程序的运行，也可以是一段SQL的执行，或者重播Profiler记录的SQL Trace，这里我们在SSMS的另一个窗口执行创建Northwind数据库的instnwnd.sql来模拟一个workload。

图1 启动Live Data窗口

当instnwnd.sql执行完毕后，先前打开的Live Data窗口会出现很多行数据，这些就是blogtest session所记录的sql_statement_starting和sql_statement_completed事件，这时可以点击工具栏上的Stop Data Feed按钮（工具栏第二个按钮），这样可以避免和workload无关的事件继续被Live Data窗口显示，如图2 所示。

图2 Live Data窗口

你的Live Data窗口可能只有2个列，name和timestamp，这是仅有的2个所有扩展事件共有的列，你可以选择工具栏上的Choose Columns…按钮添加/删除需要显示的列，我增加了3个列database_name，duration和statement，如图3所示。

图3 选择列

我们要找到Northwind数据库里平均执行时间最长的query，首先我们可以过滤不必要的事件，前文曾提到过Predicate可以在SQL Server端避免不需要的事件被产生，我们同时也支持客户端的过滤器，这可以帮助你做各种分析。点击工具栏上的Filters…按钮，这将打开Filters对话框，这里我们设置两个条件name=sql_statement_completed And database_name=Northwind，如图4所示。为了避免输入错误，你可以从事件列表里拷贝粘帖，你还可以右键点击某个Cell然后选择Filter by this Value，这将自动为你添加一个子句并And到原有条件上。

图4 Filter对话框

过滤掉不必要的事件后我们按照statement来做分组，点击工具栏上的Grouping…按钮，把statement移动到右边，点击OK，如图5所示。

图5 Grouping对话框

分组的目的是为了计算每个分组上duration的平均值，下面可以点击工具栏上的Aggregation…按钮，我们在duration上选择AVG，然后选择在duration(AVG)上按降序排序，如图6所示。

图6 Aggregation对话框

这样duration平均值最大的分组将被显示在第一行，我执行instnwnd.sql的workload里duration最大的分组是INSERT "Order Details" VALUES(10444,17,31.2,10,0)，它的duration是134206微秒，如图7所示。这样我们就找到了平均开销最大的query。

图7 开销最大的query

前文在创建blogtest session时增加了event_file的target，如果你打开SQL Server所在机器的Log目录（比如C:\Program Files\Microsoft SQL Server\MSSQL11.MSSQLSERVER\MSSQL\Log），你会发现一堆blogtest*.xel，你可以双击任何一个文件在SSMS里打开和Live Data类似的窗口，也可以通过SSMS的File|Open|Merge Extended Event Files…菜单在同一窗口里打开多个文件，后面的数据分析和Live Data窗口是一样的。

软件开发工程师 徐进

首先我们提供了一个功能强大的对话框用于创建/修改SQL Server里的XEvent Session，你可以在Object Explorer里右键点击Extended Events下的Sessions节点选择New Session…来新建一个Session，如图1所示。这将打开新建Session对话框，这个对话框有4个页面，分别是General、Events、Data Storage （Targets）、Advanced页面，下面我们一一介绍。

图1 新建Session

第一个General页面里你可以输入Session的名字，选择一些选项，比如Session是否和SQL Server一起启动，Session创建成功后是否立即启动该Session等等。我们支持与Profiler里模板类似的概念，只要选择一个模板，Event（包括Action和Predicate）和Target以及某些选项就自动选择好了，但是在CTP3里只有一个Standard模板，这个模板所选择的事件和Profiler里的Standard模板相对应。你也可以把自己创建的Session作为模板保存起来以备后用，保存模板只需要右键点击某个Session然后选择Export Session…即可。这里我们输入blogtest，并选择”Start the event session immediately after session creation”让blogtest在创建成功后立即启动，如图2所示。

图2 General页面

点击左边的Select a page列表里的Events切换到Events页面，这个页面是最复杂的，也是UI能够给你提供最大帮助的地方。你首先看到它分为左右两部分，左边是事件库，所有在SQL Server里注册的扩展事件都列在这里，右边是你选择的事件。在事件的选择上我们做了很多工作来帮助您：1. 你可以点击抬头排序，默认是按事件名排序；2. 可以输入关键字进行过滤，比如图3中我们输入sql_，所有名字含有sql_字样的事件都被列了出来并且高亮显示，过滤可以作用在事件名称上，也可以在事件的名称和描述上，或者事件所含的Fields上，你可以点击事件库右上方的ComboBox切换，所有的过滤都有高亮显示；3. 在Category和Channel上我们实现了和Excel类似的过滤过能，你可以点击Channel右边的下拉箭头选择只看Analytic channel的事件。

找到你需要的事件后，双击它或者点击两部分中间的>按钮加入选择，在这里我们选择了sql_statement_starting和sql_statement_completed事件。你可能注意到了有两个小图标（闪电和漏斗）显示在已选择事件的列表中，下面会介绍。

图3 在Events页面里选择事件

点击Events页面右上方的Configure按钮，页面将会滑动，事件库被隐藏，而配置事件的页面将出现，如图4所示，当然你点击Select可以回到刚才的页面。你会看到闪电和漏斗图标分别出现在了右边配置页面的Actions标签和Filter标签上，闪电代表的是该事件上有多少Global Fields（Actions）关联，漏斗代表该事件有没有Filter（Predicate）关联。

Action是指在发生事件的时刻可以读取的环境数据，比如event_sequence可以为所有事件排序，Profiler里每个事件都含有EventSequence列，而在XEvent里则被作为Action来实现了。

Predicate可以减少不必要的事件收集，比如我可以配置sql_statement_starting事件的Predicate为database_name=’Northwind’，那么发生在其他数据库的sql_statement_starting事件就不会被该Session所收集，Profiler可以为所有事件设置一个Column Filter，而XEvent支持为每个Event设置各自独立不同的Predicate，有兴趣可以参考MSDN里扩展事件对Action和Predicate的介绍。Event Fields标签列出所有该Event的列，某些Event会把一些开销比较大的列作为可选的列，你可以点击前面的CheckBox选择是否收集该列数据，比如sql_statement_starting的statement列就可以被取消选择。

你可以同时选择多个Event并选择/取消Action或配置Filter，在这里我们为sql_statement_starting和sql_statement_completed事件选择database_name action，不添加Filter并保持Event Fields默认值。

图4 在Events页面里配置事件

第三个页面是Data Storage页面，在这个页面里可以选择为Session添加不同的Target，这里我们选择event_file target并保持默认配置。

图5 Data Storage页面

最后一个页面是Advanced页面，这是可以设置控制Session行为的高级选项。有一个选项需要特别注意，”Maximum dispatch latency”，它描述了事件从被触发到写入到Target最长的等待时间，默认值是30秒，如果你使用和Profiler client-side tracing类似的Live Monitoring功能，你可能会希望把它改小，这样事件被触发后可以尽快地显示在SSMS里，但需要注意到是改小它会增加SQL Server的开销，这里我们把它改成5秒。

图6 Advanced页面

点击OK，blogtest session将会被创建成功并显示在Object Explorer里，在Session被创建后，你可以在Object Explorer里右键点击该Session并选择Properties，这将打开和创建Session相同的对话框，进行修改后点击OK即可完成。

右键点击blogtest选择”Watch Live Data”，这将打开前面提到的Live Monitoring功能，我们将会在后续的博文里继续介绍它。

软件开发工程师 徐进

在刚刚结束的Microsoft TechEd China 2011中，我们在分会的一个小时里为大家讲解并演示了如何利用Contained Database和DAC来开发基于SQL Server "Denali"和SQL Azure之上的应用程序。为了能够和更多的开发人员和DBA介绍和分享CDB及DAC，并提供相关资源和工具下载的链接，我们特撰文如下，希望有所帮助。

背景

让应用程序的数据层可以在本地SQL Server服务器、私有云、共有云之间方便的部署、移动、升级和管理，正在迅速成为当前云时代的关键技术之一。SQL Server “Denali” 的新增功能——包含的数据库Contained Database (CDB) 和数据层应用DAC正是为了满足这一需求而研发并推出的。这两项技术在一起所提供的功能，将SQL Server应用程序的开发、部署、和不同环境之间的移动完全流程化了，让开发人员和DBA能够淋漓发挥，游刃有余。

进展

亮点简述

• 包含的数据库Contained Database (CDB)：排序规则和安全认证已经可以内置在CDB中；
• 数据层应用DAC：BACPAC既包含数据库的元信息，也包含数据；原地升级；可以防止篡改；
• 代码名为“Juneau”的SQL Server开发工具：基于Visual Studio 2010，可以从现有数据库中提取信息新建项目；智能感知（IntelliSense）；可深层验证；版本化build；可声明目标平台，定义服务器选择策略；界面友好直观；
• 导出导入工具：广泛支持SQL Server 2000（仅支持导出）、2005、2008、2008 R2、SQL Server Denali及SQL Azure。

相关资源及下载：

• 微软MSDN 英文介绍 “包含的数据库”
• SQL数据库导入导出工具
• 微软技术白皮书 英文《SQL Server 2008 R2 中的数据层应用程序》
• SQL Server开发工具"Juneau"
• 微软MSDN 中文 SQL Server论坛

最后，为了让更多的开发人员和DBA了解CDB及DAC，我们会在10月24日进行一个同样内容的网络直播，详细信息和注册请参考http://technet.microsoft.com/zh-cn/hh506399 。

谢谢大家！

微软SQL Server产品组　刘劲浩，刘春雨

首先我们需要连接目标数据库，点击工具条上的Connect to SQL Server，输入Server name，在Database里输入HR，如图1所示。如果你的SQL Server里不存在HR数据库，点击Connect后SSMA会提示错误，问你是否创建HR数据库，选择Yes。HR数据库创建后SSMA可能会提示SQL Server Agent未运行，这仅在使用服务器端数据迁移时才会用到，默认情况下我们使用的是客户端数据迁移，所以可以点击Continue忽略。 

图1 连接到SQL Server服务器

连接上SQL Server服务器后我们就可以迁移Schema了，这里的Schema指数据以外的数据库定义，比如表结构、视图定义、存储过程等等。右键单击Oracle Metadata Explorer里的HR数据库，选择Convert Schema，如图2所示。SSMA运行一段时间后会在最下方的Output栏里显示转换是否有错误、警告或信息。这时你可以展开SQL Server Metadata Explorer里HR数据库的dbo schema，在Procedures文件夹下会发现ADD_JOB_HISTORY等存储过程，Tables文件夹下会发现COUNTRIES等表，说明Schema的迁移已经成功。

图2 转换Schema

如果这时你使用SQL Server客户端工具SQL Server Management Studio或者Visual Studio的Server Explorer查看SQL Server上的HR数据库，你会发现找不到前面所说的存储过程、表或者视图。这是因为Convert Schema菜单项只是在SSMA的Project里进行了转换，并未转换到数据库。这么设计为了让你可以在同步到SQL Server之前再做些其他修改，比如REGIONS表里的REGION_ID列在Oracle里是NUMBER类型，它被SSMA转换成了最安全的float(53)类型，如果你知道REGION_ID就是个整形，你可以把它修改为int类型，当然你最好对COUNTRIES表的REGION列也做同样的修改。

在确认Schema迁移没有问题后，你可以同步到SQL Server数据库了，在SQL Server Metadata Explorer里右键点击HR数据库，选择Synchronize with Database，如图3所示。

图3 同步HR数据库到SQL Server

这时可能会再次弹出SQL Server连接对话框和SQL Server Agent未运行的警告，确认后会显示Synchronize with the Database对话框，如图4所示。对话框里列出了SQL Server数据库和SSMA的树结构的差别，可以选择Hide Equal Objects来过滤掉两边相同的对象。由于我们连接的是新创建的HR数据库，所以左侧显示的都是 [Not Found] 状态，如果你之前做过同步这里会显示不同的状态，这里我们点击OK继续。等待右下角的进度条走完，留意主窗口Output栏是否报错，没有报错的话SQL Server里的对象应该已经创建好了。 

图4 Synchronize with the Database对话框

再次使用SQL Server Management Studio或者Visual Studio来查看HR数据库中的对象，会发现一些$SSMA打头的表或者存储过程等，这些是迁移一些特殊对象（比如Oracle的Sequence对象）所创建出来的辅助对象。

在成功迁移了Schema之后，我们就可以来进行迁移的最后一步：数据迁移。有了SSMA的帮助数据迁移也非常简单，右键点击Oracle Metadata Explorer里的HR数据库，选择Migrate Data，如图5所示。SSMA会再次提示Oracle和SQL Server的连接信息，如果之前做过数据迁移可能会有数据覆盖的警告信息，如果有点击Continue继续。

图5 数据迁移

如果你的数据库数据比较多，SSMA会运行较长一段时间，在这过程中你可以随时点击工具栏上的Stop按钮来停止数据迁移。迁移结束后，SSMA会有一个数据迁移报告，如图6所示。该报告描述了迁移过程中那些表的数据被成功迁移，多少行数据被迁移以及耗时多少等等。 

图6 数据迁移报告

本文简单介绍了如何使用SSMA for Oracle 5.0来帮助我们把一个Oracle数据库迁移到SQL Server数据库，包括迁移评估、Schema迁移以及数据迁移。

软件开发工程师 徐进

这里我们选择SSMA for Oracle 5.0为例介绍一下SSMA如何帮助您从Oracle迁移到SQL Server 2008 R2。首先我们从这里下载SSMA for Oracle 5.0的压缩包，解压缩后有两个exe文件，SSMA for Oracle 5.0.exe是工具的安装包，SSMA for Oracle 5.0 Extension Pack.exe必须安装在SQL Server 2008 R2所在服务器，用来创建一些辅助运行需要的数据库表和存储过程等。

首次运行SSMA for Oracle需要一个License，如图1所示，你可以点击链接，然后根据提示填写个人信息后免费申请，下载保存之后返回这个对话框选择你保存License的目录然后点击Refresh License按钮即可运行SSMA for Oracle了。

图1  License Management对话框

在主窗口File菜单中选择New Project…菜单项将显示图2所示的对话框，输入项目的名字，选择SQL Server 2008作为迁移的目标数据库版本。

图2  New Project对话框

我们将使用Oracle XE的HR schema为例（下文称之为HR数据库以避免歧义，但其实Oracle并没有SQL Server数据库类似的概念）。SSMA为提高性能，缺省情况下不加载某些示例数据库（包括HR数据库），这个缺省设置可以通过Project Settings来修改，选择Tools菜单的Project Settings菜单项，在弹出的对话框里点击General再选择Loading System Objects，然后勾选HR，如图3所示。

图3 Project Settings对话框

然后我们连接Oracle服务器，点击工具条上的Connect to Oracle，输入Server名称、SID和用户名/密码，如图4所示。连接后会有个警告对话框告诉你hr用户没有足够的权限。由于我们只需要迁移HR数据库，这里可以点击Continue忽略它。如果你的Oracle服务器上有很多数据库，数据加载可能需要比较长的时间，请耐心等待

图4 连接到Oracle服务器

连接上Oracle后我们首先评估一下迁移HR数据库会不会碰到问题，如果碰到问题大约需要多长时间来解决。评估并不需要连接目标SQL Server，只需要在左上方的树里展开Oracle服务器名称，然后展开Schemas，右键点击HR并选择Create Report，如图5所示。

图5 评估HR数据库

SSMA运行一段时间后会打开一个评估报告的对话框，如图6所示。这个评估报告很有用，里面会列出HR数据库里各种对象（包括函数、包、存储过程、表和视图等）能够成功迁移的比例，你可以在左边的树里选择你需要查看的某个对象，比如存储过程，比较Oracle的PL/SQL语法和迁移后的TSQL语法。

图6 评估报告

图7是一个包含有错误的评估报告，当包含错误时，SSMA会估算手工做转换大约需要多少时间，这样你就可以使用评估报告来帮助你做数据库迁移的时间规划。

图7 一个包含错误的评估报告

（未完待续）

软件开发工程师 徐进

本文将介绍EventFlowDebugger基本使用方法。

EventFlowDebugger分为在线模式和离线模式两种使用方法。在线模式下，用户连接到StreamInsight服务器，在线进行调试，或者录制某一段时间的事件流供离线模式使用。离线模式下，用户通过加载Trace文件对事件流进行调试。

下面对其主要功能进行介绍。

连接到服务器（在线）

在线模式需要用户连接到一个正在运行的StreamInsight服务器。

StreamInsight服务器有两种，嵌入服务器和远程服务器：

• 嵌入服务器（Embedded Server）：var cepServerEmbedded = Server.Create();
• 远程服务器（Remote Server）：var cepServerRemote = Server.Connect("http://servername/StreamInsight");

如果使用远程服务器，则用户可以直接连接远程服务器的地址。如果程序使用嵌入服务器，则需要在程序中添加如下代码： 

ServiceHost _dvHost = null;
IManagementService _service = null;
IManagementService proxy = server.CreateManagementService();
_service = proxy;
_dvHost = new ServiceHost(proxy);

WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message);
binding.Security.Message.ClientCredentialType = MessageCredentialType.Windows;
binding.MaxReceivedMessageSize = 4655360;
_dvHost.AddServiceEndpoint(typeof(IManagementService), binding, "http://localhost:8080");
_dvHost.Open();

同时需要添加引用Microsoft.ComplexEventProcessing.ManagementService.dll，输入加亮部分地址就可以连接嵌入服务器了。

连接到服务器的几种常见错误

错误1

HTTP could not register URL http://+:8001/. Your process does not have access rights to this namespace (see http://go.microsoft.com/fwlink/?LinkId=70353 for details).

这个错误是由于用户对访问的URL没有权限。解决方法如下：

1. netsh http add urlacl url=http://localhost:8090/MyStreamInsightServer user=<domain\userid>
2. net localgroup StreamInsightUsers$Default /ADD SOMEDOMAIN\someuser

错误2

一般是URL地址不正确或者StreamInsight程序没有运行。

错误3

 一般是由于StreamInsight程序没有运行。

错误4

 
一般是由于用户没有添加到正确的组。注意检查如下几个用户组：StreamInsightUsers$***, Performance Log Users

错误5

这个错误一般是由于用户程序中有断点。

显示查询（在线和离线）

在通过在线模式连接服务器或者离线模式打开trace文件后，用户可以查看查询的图形化界面：

在线模式下，用户可以通过菜单上的“开始录制”和“停止录制”录制一段时间的事件流。也可以采用Trace.cmd start <文件名>.etl和Trace.cmd stop <文件名>.etl来录制。

事件流分析（在线和离线）

用户可以通过如下菜单来实现对事件流的调试：

  
重播菜单可以通过但不模式从头开始一步一步调试事件流的变化，也可以直接跳转到用户设置的断点。寻根分析（Root Cause Analysis）可以找出指定事件的事件源。演化分析（Event Propagation Analysis）可以更重指定事件之后的所有演变。通过多个菜单的综合运用，用户就可以找出事件流中的异常事件数据，并进行更进一步的分析。

更多信息，请参见：

http://technet.microsoft.com/zh-cn/library/ff518532.aspx

软件测试工程师 金晶

IEnumerable与IObservable最大的区别在于IEnumerable是采用Pull模式获取数据，而IObservable则是用Push模式推送数据。

用户首先通过IEnumerable.GetEnumerator来获得数据源的Enumerator，然后通过调用IEnumerator.MoveNext和IEnumerator.Current来获取数据。StreamInsight的输入输出通过一个数据队列连接。输入适配器获得数据，并调用Enqueue将数据放入队列，输出适配器循环检测队列是否为空，如果不是空队列，则调用Dequeue将数据取出。

在HelloInsight程序基础上，可以通过如下修改来实现IEnumerable接口。

1、获取输入数据源的Enumerator（HelloPointInput.cs）：

private void ProduceEvents()

{

    while (AdapterState != AdapterState.Stopping)

    {

        if (stringEnumerator.MoveNext())

        {

            try

            {

                var line = stringEnumerator.Current;

                var pendingEvent = CreateInsertEvent();

                pendingEvent.StartTime = DateTime.Now;

                pendingEvent.Payload = new HelloPayload

                {

                    str = line

                };

                EnqueueOperationResult result;

                result = Enqueue(ref pendingEvent);

                if (result == EnqueueOperationResult.Full)

                {

                    Thread.Sleep(1000);

                    //Ready();

                    return;

                }

                EnqueueCtiEvent(DateTime.Now);

                Thread.Sleep(1000);

            }

            catch

            {

                //error handling should go here

            }

        }

        else

        {

            break;

        }

    }

    Stopped();

}

注意：在IEnumerator模式下，CTI事件是必须的，否则不会产生数据输出。

3、循环读取队列中的数据，并进行输出处理（HelloPointOutput.cs）：

private void ConsumeEvents()

{

    PointEvent<HelloPayload> currEvent;

    DequeueOperationResult result;

    while (AdapterState != AdapterState.Stopping)

    {

        result = Dequeue(out currEvent);

        if (result == DequeueOperationResult.Empty)

        {

            Ready();

            return;

        }

        else

        {

            if (currEvent.EventKind == EventKind.Insert)

            {

                Console.WriteLine("Output: " +

                currEvent.Payload.str

                );

            }

            ReleaseEvent(ref currEvent);

        }

    }

    Stopped();

}

4、运行程序

建立测试文件：

将输入数据源指向测试文件的存储地址。运行程序，得到如下输出：

HelloInsight.zip

Observer是.net Framework 4中引入的开发模式。IObserver<T>和IObservable<T>接口为基于推送的通知提供通用机制，也称为观察者设计模式。IObservable<T> 接口表示发送通知（提供程序）的类；IObserver<T> 接口表示接收通知（观察器）的类。

在下列应用场景下，适合采用Observable模式：

1. 历史数据查询。对有限长的大数据集进行临时的查询。
2. Ad hoc查询。对数据进行一系列交互的ad hoc查询。
3. 内嵌于用户程序。StreamInsight内嵌于用户应用程序之中。

使用这种开发模型，开发者只需要：

1. 实现IObservable接口
2. 实现IObserver接口
3. 绑定到查询

下面将用示例代码来说明.。

1、安装Reactive Extension for .Net 4： 

2、新建一个工程，注意选择.net framework 4.0。

3、添加如下引用。System.CoreEx和System.Reactive在C:\Program Files\Microsoft Cloud Programmability\Reactive Extensions\v1.0.2856.0\Net4\目录下。

定义事件Payload：

namespace HelloInsightObservable

{

    public class HelloPayload

    {

        public int value { get; set; }

    }

}

5、定义InputObservable类实现Iobservable接口

public class InputObservable : IObservable<int>

这个类需要实现Subscribe方法：

public IDisposable Subscribe(IObserver<int> observer)

{

    if (observer != null && !this.observers.Contains(observer))

    {

        this.observers.Add(observer);

    }

    return observer as IDisposable;

}

我们还需要在这个类里模拟输入。我们定义了一个Timer，当定时器时间到时，调用定时器的回调函数生成一个随机整数，并调用observer的OnNext方法推送数据。

private void GenerateInput(object _)

{

    foreach (var observer in observers)

    {

        int value = random.Next(100);

        Console.WriteLine("Random generated data {0} : {1}", generatedNumber, value);

        observer.OnNext(value);

        generatedNumber++;

        if (generatedNumber >= dataNumber)

        {

            observer.OnCompleted();

            timer.Change(Timeout.Infinite, timeSpan);

            return;

        }

    }

    timer.Change(timeSpan, timeSpan);

}

6、将Observable类作为CEP引擎的输入。

在Main函数中添加如下代码。注意加亮部分的代码，这里与适配器方式的程序不同的是，没有插入CTI事件。

var inputObservable = new InputObservable(10);

using (var server = Server.Create("DefaultInstance"))

{

    var application = server.CreateApplication("Observable Application");

    var stream = inputObservable.ToPointStream(application,

            e => PointEvent.CreateInsert(DateTime.Now, new HelloPayload { value = e }),

            AdvanceTimeSettings.StrictlyIncreasingStartTime,

            "Observable Stream");

    var query = from e in stream

                where e.value > 50

                select e;

}

7、定义OutputObserver类实现Iobserver接口。

class OutputObserver : IObserver<HelloPayload>

{

    public virtual void OnCompleted()

    {

        Console.WriteLine("Stopping query...");

    }

    public virtual void OnError(Exception e)

    {

        Console.WriteLine("Unexpected error occured");

    }

    public virtual void OnNext(HelloPayload payload)

    {

        Console.WriteLine("DataOutput: {0}", payload.value);

    }

}

8、将OutputObserver绑定到query。

在main函数中添加如下代码：

var outputObserver = new OutputObserver();

var outputObservable = query.ToObservable();

outputObservable.Subscribe(outputObserver);

Console.ReadLine();

Subscribe函数执行后，就会开始接收数据输入，并调用OnNext方法输出。注意最后一句话的作用是让程序继续运行直至数据输入完成，Observable调用Observer的OnComplete方法，或者用户中途通过输入任意字符停止Observer。

9、程序运行的结果如下：

HelloInsight.zip

讲师： 资深项目经理  王清越

你有Oracle数据库要迁移到SQL Server吗？微软提供了一个免费的工具来帮你做数据库迁移。我们会讨论迁移到 SQL Server的好处，和如何用SQL Server迁移助理（SSMA）来自动做数据库迁移。我们会演示如何用SQL Server迁移助理来迁移数据库模式和PL/SQL程序等。我们一起探讨SQL Server迁移助理（SSMA）如何为你节省数据库迁移的时间和成本。

[View:http://wm.microsoft.com/ms/china/technet/howtovideo/sqlserver2008/20110317_SSMAforOracle.wmv]

如果有什么问题，请直接通过评论提出。