Azure Core Expressions DataFactory shared client library for .NET

Azure.Core.Expressions.DataFactory provides classes that represent Expressions.

Getting started

Typically, you will not need to install Azure.Core.Expressions.DataFactory; it will be installed for you when you install one of the client libraries using it. In case you want to install it explicitly (to implement your own client library, for example), you can find the NuGet package.

Key concepts

In the datafactory API many of the properties have the ability to either be a constant value, an expression which will be evaluated at runtime, a secure string, or a reference to a key vault secret. The structure of the JSON payload is different depending on which of these concepts the value maps to. As an example, the FolderPath property of an AzureBlobDataset can either be a "string (or Expression with resultType string)". Implicit in this definition is the fact that it can also be a secure string or a key vault secret reference. This is true for any property that can be expressed as a string or an expression with a result type of string.

Json representation

Literal

"folderPath": "foo/bar"

Expression

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

In this example when the pipeline is run in the first case the folder is always foo/bar, but in the second case the service will append the time the pipeline kicked off to the folder name.

Secure String

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

When a secure string is used, the value is return masked with '*' characters when the resource is retrieved from the service.

Key Vault Secret Reference

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