在仔細考慮之後，我們決定停止 Amazon Kinesis Data Analytics for SQL 應用程式：

1. 從 **2025 年 9 月 1 日起，**我們不會為 Amazon Kinesis Data Analytics for SQL 應用程式提供任何錯誤修正，因為考慮到即將終止，我們將對其提供有限的支援。

2. 從 **2025 年 10 月 15 日起，**您將無法建立新的 Kinesis Data Analytics for SQL 應用程式。

3. 我們將自 **2026 年 1 月 27** 日起刪除您的應用程式。您將無法啟動或操作 Amazon Kinesis Data Analytics for SQL 應用程式。從那時起，Amazon Kinesis Data Analytics for SQL 將不再提供支援。如需詳細資訊，請參閱[Amazon Kinesis Data Analytics for SQL 應用程式終止](discontinuation.md)。

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

# 步驟 3.3：新增實時分析 (新應用程式碼)
<a name="get-started-add-realtime-analytics"></a>

您可以針對應用程式內串流撰寫自己的 SQL 查詢，但在接下來的步驟中，您可以使用其中一個提供範例程式碼的範本。

1. 在應用程式中樞頁面，選擇**至 SQL 編輯器**。  
![\[帶有 SQL 編輯器按鈕的範例應用程式頁面之螢幕截圖。\]](http://docs.aws.amazon.com/zh_tw/kinesisanalytics/latest/dev/images/gs-v2-40.png)

1. 在**您要開始運行「範例應用程式」嗎？**對話方塊中，選擇**是，啟動應用程式**。

   主控台會傳送啟動應用程式的要求 (請參閱 [StartApplication](API_StartApplication.md))，然後 SQL 編輯器頁面就會出現。

   

1. 主控台會開啟 SQL 編輯器頁面。檢閱頁面，包括按鈕 (**從範本新增 SQL**、**儲存並執行 SQL**) 和各種標籤。

1. 在 SQL 編輯器中，選擇**從範本新增 SQL**。

1. 從可用範本清單中，選擇**連續篩選**。範例程式碼會從一個應用程式內串流讀取資料 (`WHERE` 子句會篩選資料列)，並將其插入另一個應用程式內串流，如下所示：
   + 此舉會建立應用程式內串流 `DESTINATION_SQL_STREAM`。
   + 此舉會建立幫浦 `STREAM_PUMP`，並用它從 `SOURCE_SQL_STREAM_001` 中選取列並插入 `DESTINATION_SQL_STREAM`。

   

1. 選擇**將此 SQL 新增至編輯器**。

1. 依照下列方式來測試應用程式碼：

   請記住，您已經啟動了應用程式（狀態為 RUNNING）。儲存組態時，Amazon Kinesis Data Analytics 已持續從串流來源讀取資料，並將資料列加入應用程式內串流 `SOURCE_SQL_STREAM_001`。

   1. 在 SQL 編輯器中，選擇**儲存並執行 SQL**。主控台首先發送更新請求，以保存應用程式碼。然後，程式碼會持續執行。

   1. 您可以在**即時分析**標籤中查看結果。  
![\[SQL 編輯器的螢幕截圖，結果顯示在即時分析標籤中。\]](http://docs.aws.amazon.com/zh_tw/kinesisanalytics/latest/dev/images/gs-v2-50.png)

      SQL 編輯器包含下列標籤：
      + **來源資料**標籤會顯示映射至串流來源的應用程式內輸入串流。選擇應用程式內串流，您就可以看到傳入的資料。請注意應用程式內輸入串流中的其他資料欄，輸入組態並未指定這些欄位。其中包括下列時間戳記欄：

         
        + **ROWTIME**：應用程式內串流中的每一列都有一個名為 `ROWTIME` 的特殊欄。此資料欄是 Amazon Kinesis Data Analytics 在第一個應用程式內串流 (對應至串流來源) 中插入資料列的時間戳記。

           
        + **Approximate\$1Arrival\$1Time**：每個 Kinesis Data Analytics 記錄都包含一個稱為 `Approximate_Arrival_Time` 的值。當串流來源成功接收並儲存記錄時，此值即為大約的到達時間戳記。Kinesis Data Analytics 從串流來源讀取記錄時，會將此資料欄擷取到應用程式內輸入串流中。

        這些時間戳記值在以時間為基礎的窗口化查詢中非常有用。如需詳細資訊，請參閱[窗口化查詢](windowed-sql.md)。

         
      + **即時分析**標籤會顯示應用程式碼建立的所有其他應用程式內串流。其中還包括錯誤串流。Kinesis Data Analytics 會將任何無法處理的資料列傳送至錯誤串流。如需詳細資訊，請參閱[錯誤處理](error-handling.md)。

         

        選擇 `DESTINATION_SQL_STREAM` 檢視應用程式碼插入的資料列。請注意應用程式碼未建立的其他資料欄。其中包括 `ROWTIME` 時間戳記欄：Kinesis Data Analytics 只會從來源 (`SOURCE_SQL_STREAM_001`) 複製這些值。

         
      + **目的地**標籤會顯示 Kinesis Data Analytics 寫入查詢結果的外部目標。您尚未為應用程式輸出設定任何外部目的地。

      

**後續步驟**  
[步驟 3.4：(選用) 更新應用程式碼](get-started-update-appcode.md)