你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

切片版本 1 (V1)

  • 项目

注意

本参考文档适用于Azure 数据工厂版本 1 (V1) 。

Get

获取数据工厂中表的数据切片。

请求

Get Slice 请求可以按如下方式构造（建议使用 HTTPS）：

HTTP 谓词 请求 URI HTTP 版本
GET https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/tables/{TableName}/slices?start={StartDateTime}&end={EndDateTime}&api-version={api-version} HTTP/1.1

URI 参数

URI 参数 必需 说明
订阅 ID 是 Azure 订阅 ID。
ResourceGroupName 是 托管 Azure 数据工厂的资源组的唯一名称。
DataFactoryName 是 你要在其中查找表的数据工厂的名称。
TableName 是 要进行切片的表的名称。
StartDateTime 是 开始切片的日期时间。
EndDateTime 否 结束切片的日期时间。 默认值是开始日期时间后的 48 小时。
API 版本 是 指定用于发出此请求的协议的版本。

请求标头

下表介绍请求标头。

请求头 必需 说明
x-ms-client-request-id 是 此请求的操作 ID。

请求正文

无。

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

  • 200（正常）- 如果请求已成功完成。

  • 400（错误的请求）- 如果请求正文未通过验证。

  • 404（找不到）- 如果订阅或资源组不存在。

响应标头

此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范。

响应标头 说明
x-ms-request-id 当前操作的唯一标识符，由服务生成。
x-ms-ratelimit-remaining-subscription-writes 当前订阅的剩余限制。
x-ms-correlation-request-id 指定请求的跟踪相关 ID。 资源提供程序 必须 记录此日志，以便端到端请求可以在 Azure 中关联。
x-ms-routing-request-id Location+DateTime+correlation-request-ID
日期 服务生成的 UTC 日期/时间值指示启动响应的时间。

响应正文

  
{  
    "value": [  
    {  
        "status": <SliceStatus>,  
        "state": <SliceState>,  
        "retryCount": <RetryCount>,  
        "longRetryCount": <LongRetryCount>,  
        "statusUpdateTimestamp": <Timestamp>,  
        "start": <StartDateTime1>.  
        "end": <EndDateTime1>  
    },  
    {  
        "status": <SliceStatus>,  
        "state": <SliceState>,  
        "retryCount": <RetryCount>,  
        "longRetryCount": <LongRetryCount>,  
        "statusUpdateTimestamp": <Timestamp>,  
        "start": <StartDateTime2>.  
        "end": <EndDateTime2>  
    },  
    {  
        "status": <SliceStatus>,  
        "state": <SliceState>,  
        "retryCount": <RetryCount>,  
        "longRetryCount": <LongRetryCount>,  
        "statusUpdateTimestamp": <Timestamp>,  
        "start": <StartDateTime3>.  
        "end": <EndDateTime3>  
    }  
    ]  
}

下表介绍响应正文的元素。

元素名称 说明
SliceStatus 此切片的状态。
SliceState 切片的状态。
RetryCount 要重试切片的次数。
LongRetryCount 要长时重试切片的次数。
StartDateTime 此切片开始的日期时间
EndDateTime 此切片结束的日期时间。

示例请求和响应

示例 URI：

GET:https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/datasets/EmpSQLTable/slices?start=2015-12-09T12:00:00.0000000&end=2015-12-09T14:00:00.0000000&api-version=2015-10-01

该请求与以下标头一起发送。

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

在发送请求后，将返回以下响应。

标头：

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 799985  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:33:07 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET

响应包括以下 XML 正文。

  
{  
  "value": [  
    {  
      "status": "Ready",  
      "state": "Ready",  
      "retryCount": 0,  
      "longRetryCount": 0,  
      "statusUpdateTimestamp": "2016-02-22T23:06:59.1238656Z",  
      "start": "2015-12-09T12:00:00Z",  
      "end": "2015-12-09T13:00:00Z"  
    },  
    {  
      "status": "Ready",  
      "state": "Ready",  
      "retryCount": 0,  
      "longRetryCount": 0,  
      "statusUpdateTimestamp": "2016-02-22T23:06:59.1238656Z",  
      "start": "2015-12-09T13:00:00Z",  
      "end": "2015-12-09T14:00:00Z"  
    }  
  ]  
}

设置状态

设置数据工厂中表的切片状态。

请求

可以按如下方式构造“设置切片状态”请求（建议使用 HTTPS）：

HTTP 谓词 请求 URI HTTP 版本
PUT https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/tables/{TableName}/slices/ setstatus？start={StartDateTime}&end={EndDateTime}&api-version={api-version} HTTP/1.1

URI 参数

URI 参数 必需 说明
订阅 ID 是 Azure 订阅 ID。
ResourceGroupName 是 托管 Azure 数据工厂的资源组的唯一名称。
DataFactoryName 是 你要在其中创建表的数据工厂的名称。
TableName 是 要创建的表的名称。
StartDateTime 是 切片启动时的日期时间。
EndDateTime 是 切片结束时的日期时间。
API 版本 是 指定用于发出此请求的协议的版本。

请求标头

下表介绍请求标头。

请求头 必需 说明
x-ms-client-request-id 是 此请求的操作 ID。

请求正文

  
{  
    "SliceStatus": <NewSliceStatus>,  
    "UpdateType": <UpdateType>  
}

下表介绍响应正文的元素。

元素名称 说明
NewSliceStatus 要设置的状态。
UpdateType 指定切片的更新类型。

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

  • 200（正常）- 如果请求已成功完成。

  • 400（错误的请求）- 如果请求正文未通过验证。

  • 404（找不到）- 如果订阅或资源组不存在。

响应标头

此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范。

响应标头 说明
x-ms-request-id 当前操作的唯一标识符，由服务生成。
x-ms-ratelimit-remaining-subscription-writes 当前订阅的剩余限制。
x-ms-correlation-request-id 指定请求的跟踪相关 ID。 资源提供程序必须记录此项，以便可以通过 Azure 关联端到端请求。
x-ms-routing-request-id Location+DateTime+correlation-request-ID
日期 服务生成的 UTC 日期/时间值指示启动响应的时间。

响应正文

无。

示例请求和响应

示例 URI：

  
PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/tables/tabletest/slices/setstatus?start=2015-12-02T00:00:00.0000000&end=2015-12-02T01:00:00.0000000&api-version=2015-10-01

该请求与以下标头一起发送。

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

在发送请求后，将返回以下响应。

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 799985  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:33:07 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET