AWS Data Pipeline 不再提供給新客戶。的現有客戶 AWS Data Pipeline 可以繼續正常使用服務。[進一步了解](https://aws.amazon.com/blogs/big-data/migrate-workloads-from-aws-data-pipeline/)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 管道表達式和函數
<a name="dp-expressions-functions"></a>

本節說明在管道中使用表達式和函數的語法，包括相關資料類型。

## 簡單資料類型
<a name="dp-pipeline-datatypes"></a>

您可以將以下類型的資料設為欄位值。

**Topics**
+ [DateTime](#dp-datatype-datetime)
+ [數值](#dp-datatype-numeric)
+ [物件參考](#dp-datatype-object-reference)
+ [Period](#dp-datatype-period)
+ [String](#dp-datatype-section)

### DateTime
<a name="dp-datatype-datetime"></a>

 AWS Data Pipeline 僅支援 UTC/GMT 格式的「YYYY-MM-DDTHH：MM：SS」日期和時間。下列範例會將 `Schedule` 物件的 `startDateTime` 欄位設為 UTC/GMT 時區的 `1/15/2012, 11:59 p.m.`。

```
"startDateTime" : "2012-01-15T23:59:00"
```

### 數值
<a name="dp-datatype-numeric"></a>

 AWS Data Pipeline 同時支援整數和浮點值。

### 物件參考
<a name="dp-datatype-object-reference"></a>

管道定義中的物件。這可以是目前物件、在管道的其他位置定義的物件名稱，或在欄位中列出目前物件的物件，並以 `node` 關鍵字參考。如需 `node` 的相關資訊，請參閱 [參考欄位和物件](dp-pipeline-expressions.md#dp-pipeline-expressions-reference)。如需管道物件類型的詳細資訊，請參閱[管道物件參考](dp-pipeline-objects.md)。

### Period
<a name="dp-datatype-period"></a>

 表示排程事件的執行頻率。這會以 "*N* [`years`\$1`months`\$1`weeks`\$1`days`\$1`hours`\$1`minutes`]" 格式表示，其中 *N* 是正整數值。

最短期間為 15 分鐘，而最長期間為 3 年。

下列範例會將 `Schedule` 物件的 `period` 欄位設為 3 小時。這會建立每隔三小時執行一次的排程。

```
"period" : "3 hours"
```

### String
<a name="dp-datatype-section"></a>

 標準字串值。字串必須以雙引號 (") 括住。您可以使用反斜線字元 (\$1) 來逸出字串中的字元。不支援多行字串。

下列範例示範 `id` 欄位的有效字串值。

```
"id" : "My Data Object"

"id" : "My \"Data\" Object"
```

字串也可以包含評估為字串值的表達式。這些表達式會插入字串，並以 "\$1\$1" 和 "\$1" 分隔。下列範例使用表達式來將目前物件的名稱插入路徑。

```
"filePath" : "s3://amzn-s3-demo-bucket/#{name}.csv"
```

如需使用表達式的詳細資訊，請參閱[參考欄位和物件](dp-pipeline-expressions.md#dp-pipeline-expressions-reference)和[表達式評估](dp-pipeline-expressions.md#dp-datatype-functions)。