Azure.Core.Expressions.DataFactory 1.0.0

Azure Core Expressions DataFactory 共享客户端库用于 .NET

Azure.Core.Expressions.DataFactory 提供代表 表达式 的类。

入门教程

通常，您不需要安装 Azure.Core.Expressions.DataFactory；它在您使用该客户端库安装某个库时会自动为您安装。如果需要显式安装（例如，实现自己的客户端库），可以找到 NuGet 包。

关键概念

在datafactory API中，许多属性既可以是常数值，也可以是运行时评估的表达式，可以是安全字符串，或者是对密钥保管库秘密的引用。JSON有效载荷的结构取决于这些值映射到哪个概念。例如，AzureBlobDataset的FolderPath属性可以是“字符串（或字符串类型的表达式）”。隐含在这个定义中的是，它也可以是安全字符串或密钥保管库秘密引用。任何可以表示为字符串或字符串类型表达式的属性都是如此。

JSON表示

文字

"folderPath": "foo/bar"

表达式

"folderpath": {
  "type": "Expression",
  "value": "foo/bar-@{pipeline().TriggerTime}"
}

在本例中，在第一次运行管道时，文件夹总是foo/bar，但在第二种情况下，服务将沿袭管道启动的时间追加到文件夹名称中。

安全字符串

"folderpath": {
  "type": "SecureString",
  "value": "some/secret/path"
}

当使用安全字符串时， Tangming在从服务检索资源时，返回的值将用星号(*)字符屏蔽。

密钥保管库秘密引用

"folderpath": {
  "type": "AzureKeyVaultSecret",
  "store": {
    "type": "LinkedServiceReference",
    "referenceName": "someReferenceName"
  },
  "secretName": "someSecretName",
  "secretVersion": "someSecretVersion"
}

密钥保管库引用可用于指定存储属性值的密钥保管库。

DataFactoryElement<T>

DataFactoryElement<T>类允许我们使用强类型方法来对预期属性的字面值进行建模。如果表达式应该评估为int，则分配给同一属性的文本值也必须是int。

使用上面的FolderPath示例，我们可以使用以下任意一种情况设置属性。

文字

blobDataSet.FolderPath = "foo/bar";

表达式

blobDataSet.FolderPath = DataFactoryElement<string>.FromExpression("foo/bar-@{pipeline().TriggerTime}");

保密字符串

blobDataSet.FolderPath = DataFactoryElement<string>.FromSecretString("some/secret/path");

密钥保管库秘密引用

var store = new DataFactoryLinkedServiceReference(DataFactoryLinkedServiceReferenceKind.LinkedServiceReference,
    "referenceName");
var keyVaultReference = new DataFactoryKeyVaultSecret(store, "secretName");
blobDataSet.FolderPath = DataFactoryElement<string>.FromKeyVaultSecret(keyVaultReference);

在实际应用中，根据需求和场景，使用适当的方法可以让库有效地序列化和反序列化所有场景。

故障排除

有三种主要的方法可以排除故障：检查异常、启用日志记录和分布式跟踪

下一步

探索和安装可用的Azure SDK库。

贡献

本项目欢迎贡献和建议。大多数贡献都需要您同意一份贡献者许可协议（CLA），声明您有权利，并且实际上确实授权我们使用您的贡献。有关详细信息，请参阅https://cla.microsoft.com。

当您提交一个请求时，CLA机器人会自动确定您是否需要提供CLA并相应地修饰PR（例如标签、注释）。只需遵循机器人的指示即可。您只需在整个使用我们的CLA的存储库中这样做一次。

本项目已采用Microsoft 开源行为准则。有关更多信息，请参阅行为准则FAQ或通过 [email protected]联系以获得额外的疑问或意见。