連結至雲端儲存中的物件

當您從 Oracle Autonomous AI Database 建立雲端存放區儲存桶中檔案的連結時，會建立一個連結至雲端存放區中檔案的外部表格。

您可以連結下列檔案格式的檔案：AVRO、CSV、JSON、GeoJSON、Parquet、ORC、Delimited TXT。如需支援之檔案格式的資訊，請參閱JSON、AVRO 及 XML 檔案的格式設定。

從「連結雲端物件」頁面設定並執行資料連結工作。要開啟該頁面：

  1. 開啟「資料庫動作」啟動畫面，按一下 Data Studio 頁籤，然後選取資料載入功能表。請參閱資料載入頁面。
  2. 選取連結資料和 CLOUD STORE 。

頁面左側是導覽器窗格，您可以在其中選擇雲端存放區連線，以及包含資料的資料夾或檔案。頁面右側是資料載入購物車，您可以在其中暫存資料連結工作的檔案與資料夾。您可以在執行資料連結工作之前，設定其選項。Autonomous Database 隨附預先定義的 CPU/IO 共用，可指派給不同的用戶群組。視您的工作負載而定，您可以在執行資料載入工作時，將用戶群組設為低、中或高。

若要從雲端存放區連結至檔案，請執行下列動作：

父項主題：連結資料

管理資料連結工作的雲端儲存連結

您必須先建立想要使用之雲端存放區的連線，才能連結至雲端存放區中的資料。

在「連結雲端物件」頁面上：

  1. 在您輸入雲端存放區位置的欄位旁，按一下「管理雲端存放區」圖示。選取 + 建立雲端存放區位置。

  2. 在新增雲端存放區位置窗格中輸入您的資訊。請參閱 以新增雲端儲存位置。

請參閱管理連線。

若要返回「連結雲端物件」頁面，請按一下頁面頂端導覽路徑中的資料載入，然後返回頁面。

父項主題：連結至雲端儲存中的物件

準備資料連結工作

您可能必須調整來源資料或目標表格，以便來源資料可正確連結至外部目標表格。請考慮改用：

  • 如果要連結至多個檔案，您必須確定：

    • 所有來源檔案的類型都相同，例如 CSV、JSON 等。

    • 所有來源檔案中資料欄的數目、順序以及資料類型都相符。

  • 如果您想要依日期分割：

    • 來源檔案必須包含資料類型為日期或時戳的資料。

    • 您必須載入包含兩個或更多資料來源的資料夾。

    • 資料夾中的檔案名稱必須指出日期或日期，例如 MAR-1999.csv 或 2017-04-21.xlsx。

父項主題：連結至雲端儲存中的物件

新增資料連結工作的檔案或資料夾

從雲端存放區新增檔案至資料連結資訊轉送站，您可以在其中編輯資料連結工作的詳細資料。新增檔案：

  1. 從左側導覽器窗格頂端的清單中，使用您的來源資料選取儲存桶。

    此清單顯示「管理雲端儲存體」頁面上建立的連結。如果您尚未註冊想要使用的雲端存放區，請按一下 Data Studio 工具套件中「資料載入」功能表下的連線按鈕，然後註冊連線。

  2. 將一或多個項目從左邊的檔案導覽器拖放至右邊的資訊轉送站。

    • 您可以新增檔案、資料夾或兩者。系統會針對您拖曳至購物車中的每個檔案或資料夾新增卡片。卡片會列出來源檔案或資料夾的名稱，以及建議的目標表格名稱。

    • 如果您新增包含多個檔案的資料夾，則所有檔案的類型都必須相同，亦即 CSV、TXT 等。

      將資料夾新增至資訊轉送站時，會顯示一個提示，詢問您是否要將多個來源檔案的所有物件載入單一目標表格。按一下是以繼續，或按一下否以取消。

    • 當您將多個個別檔案或多個資料夾加入至資訊轉送站時，每個資訊轉送站所代表的資料將被載入至個別的表格中，但資訊轉送站中的所有項目將作為相同資料載入工作的一部分進行處理。

    • 您可以從其他儲存桶新增檔案或資料夾，但如果這麼做，系統會提示您先移除購物車中已有的所有檔案，再繼續進行作業。若要從其他儲存桶選取檔案，請從左側導覽器窗格的下拉式清單中選取儲存桶，然後新增檔案 (如上所述)。

    • 您可以將檔案或資料夾放入資料載入購物車，然後離開「資料連結物件」頁面。當您返回頁面時，這些項目會保留在頁面上，但您可能會收到「移除所有資料連結項目」的訊息。變更至另一個雲端儲存體位置需要從資料載入工作移除所有項目。您要繼續嗎？」按一下是以從購物車移除項目。按一下否，將項目保留在購物車中。然後您可以繼續工作。

執行資料連結工作之前，您可以從購物車中移除項目：

  • 若要從購物車中移除項目，請選取窗格頂端之「資料連結」購物車功能表列的卡片上的移除。

  • 若要從購物車移除所有項目，請按一下窗格頂端資料連結購物車功能表列中的全部移除。

父項主題：連結至雲端儲存中的物件

輸入資料連結工作的明細

在「從雲端儲存的連結資料」窗格中輸入資料連結工作的詳細資訊。

在資料連結購物車中的卡片上，按一下設定值以開啟該工作的「雲端儲存的連結資料」窗格。窗格包含：

設定頁籤 - 表格區段

在表格段落中設定目標表格的相關詳細資訊。

  • 名稱：目標表格的名稱。

  • 分割區資料欄

    列出分割區和以日期為基礎的分割區是資料連結中可用的不同類型分割區。

    當您特別想要根據分散式值將資料列對應至分割區時，就需要清單分割。

    若要根據特定資料欄進行分割，請按一下分割資料欄下拉式清單，然後選取要用於分割的資料欄。

    每個分割區值將有 N 個檔案，所有檔案都依您選取的分割區資料欄分割。

    附註：

    • 對於連結的檔案 (來自外部表格)，也需要針對每個檔案，清單分割資料欄在所有資料列中都只能包含單一不同值。
    • 若檔案清單分割，分割索引鍵只能由表格的單一資料欄組成。

    當您連結包含兩個或多個資料來源的資料夾包含日期或時戳資料的資料欄時，可以使用以日期為基礎的分割。

    若要根據日期進行分割，請按一下分割區資料欄下拉式清單，然後選取要用於分割的 DATE 或 TIMESTAMP 資料欄。

  • 驗證類型：驗證會檢查來源檔案、選擇性的分割資訊，以及不符合指定格式選項的報表資料列。選取無不進行驗證；選取範例以根據資料的範例執行驗證；或選取完整以根據所有資料執行驗證。

  • 使用萬用字元：此核取方塊可讓您在搜尋條件中使用萬用字元，以擷取符合篩選條件的特定檔案群組。

    您可以使用萬用字元，例如星號 (*) 來搜尋、篩選及指定偵測並新增檔案至外部表格的檔案群組。

    例如，如果您輸入 file*，則 file01、file02、file03 等會視為符合關鍵字。星號 (*) 會比對可能字元的零個或多個字元與關鍵字。

    附註：

    萬用字元支援與分割不相容。如果您使用含有分割資料的萬用字元，則來源檔案的驗證會失敗。

設定頁籤 - 特性區段

指定控制如何解譯、預覽及處理來源資料的選項。這些選項會根據來源資料的類型而有所不同。

  • 編碼：從清單中選取一個字元編碼類型。當連結的檔案為純文字格式 (CSV、TSV 或 TXT) 時，即可使用此選項。預設編碼類型為 UTF-8。

  • 文字外殼：選取內含文字的字元： " (雙引號字元)、 ' (單引號字元) 或無。只有在選取的檔案為純文字格式 (CSV、TSV 或 TXT) 時，才會顯示此選項。

  • 欄位分隔符號：選取用於分隔來源中資料欄的分隔符號字元。例如，如果來源檔案使用分號來分隔資料欄，請從清單中選取分號。預設值為逗號。只有在選取的檔案為純文字格式 (CSV、TSV 或 TXT) 時，才會顯示此選項。

  • 在資料列開始處理資料：指定將來源資料連結至目標外部表格時要略過的資料列數目：

    • 如果您選取來源資料欄名稱下的資料欄標頭資料列選項 (請參閱下方)，且如果您在開始處理資料列的資料欄位中輸入大於 0 的數字，則第一個資料列之後的該資料列數目不會連結至目標。

    • 如果您取消選取來源資料欄名稱下的資料欄表頭資料列選項，且如果您在在資料列開始處理資料欄位中輸入大於 0 的數字，則包含第一個資料列的資料列數目不會連結至目標。

  • 來源資料欄名稱：選取資料欄標頭資料列核取方塊，以使用資料欄名稱作為目標表格中的來源表格。

    • 如果您選取此選項，檔案中的第一列會處理為欄名稱。下方對應區段中的資料列會填入這些名稱 (除非您變更這些名稱，否則會使用現有的資料類型)。

    • 如果您取消選取此選項，則會將第一列處理為資料。若要手動指定資料欄名稱，請在對應區段中輸入每個目標資料欄的名稱。(您也必須輸入資料類型。)

  • 數值資料欄：選取將無效的資料轉換成空值核取方塊，將無效的數值資料欄值轉換成空值。

  • 資料值中包含的換行字元：如果有換行字元，或返回目前行的開頭，但不在資料欄位中向下移動，請選取此選項。選取此選項會增加處理載入所需的時間。如果您在載入資料時未選取此選項，則欄位中有換行字元的列將會被拒絕。您可以在「工作報表」面板中檢視拒絕的資料列。

設定頁籤 - 對應區段

對應區段中的設定值可控制來源檔案的資料如何連結至目標外部表格的資料列。對於每個資料列，來源資料欄底下所列資料欄的資料將會連結至目標資料欄底下所列的資料欄。

  • 來源資料欄：列出來源檔案的資料欄。

    如果選取特性底下的資料欄標頭資料列選項，來源資料欄會顯示來源檔案中資料欄的名稱。如果未選取資料欄標頭資料列選項，則會使用 COLUMN_1 、 COLUMN_2 等一般名稱。此欄位一律為唯讀。

    您可以檢視兩個來源資料欄 FILE$NAME 和 SYSTIMESTAMP。FILE$NAME 資料欄可讓您尋找包含特定資料記錄的來源檔案。例如，載入包含檔案清單的來源檔案。檔案清單中的檔案名稱會參照整個組織的部門名稱。例如， finance.txt 檔案包含來自「財務」部門的資料。在對應中，您可以使用字串資料類型，從檔案名稱資料欄的輸出中擷取部門名稱。您可使用擷取的部門名稱，以不同方式處理每個部門的資料。

    SYSTIMESTAMP 資料欄可讓我們檢視資料庫中的目前時戳。

    附註：

    • 預設不會包含 FILE$NAME 和 SYSTIMESTAMP 來源資料欄。您必須勾選包含核取方塊，然後執行目標表格的載入以顯示這兩個資料欄。
    • 建立即時饋送時，依預設，「對應」表格中會顯示 FILE$NAME 和 SYSTIMESTAMP 來源資料欄。

  • 目標資料欄：列出目標表格中的資料欄。

    • 如果選取資料欄標頭資料列選項，則目標資料欄會使用來源檔案中的資料欄名稱。您可以將提供的名稱取代為新的名稱來變更目標資料欄的名稱。您必須確定目標資料欄不是空的。目標資料欄名稱不能是另一個目標資料欄的重複項目。目標資料欄名稱不能有另一個目標資料欄的重複名稱。目標資料欄長度不得超過 128 個位元組。128 個位元組的限制是資料庫的限制。

    • 如果資料欄表頭資料列選項未選取，則會使用 COLUMN_1 、 COLUMN_2 等一般名稱。您可以將提供的名稱取代為新的名稱來變更目標資料欄的名稱。

    附註：

    如果您在單一資料連結工作中連結資料夾的多個檔案，則對應區段中只會顯示第一個檔案。不過，只要資料欄名稱和資料類型相符，就會連結所有來源檔案的資料。

  • 資料類型：列出要用於該資料欄資料的資料類型。內容會根據是否選取從檔案標頭取得選項而變更。

    • 如果選取資料欄標頭資料列選項，則資料類型會顯示來源檔案中資料欄的資料類型。若要變更目標的資料類型，請按一下名稱，然後從清單中選取不同的名稱。

    • 如果資料欄標頭資料列選項未選取，則資料類型會顯示所有可用的資料類型。從清單中選取用於目標資料欄的資料類型。

  • 長度 / 精確度 (選擇性)：對於資料類型為 NUMBER 的資料欄，請輸入資料欄中數字的長度 / 精確度。精確度是數字中的有效位數。精確度的範圍從 1 到 38。

    對於「資料類型」為 VARCHAR2 的資料欄，長度 / 數字位數欄位中的自動值會啟用「自動大小」功能。

    使用「自動調整欄寬度」功能，您可以自動調整任何欄的大小，以符合欄中的最大值。從長度 / 數字位數下拉式清單中選取自動，或從下拉式清單中選取值。

  • 比例 (選擇性)：對於資料類型為 NUMBER 的欄，請輸入欄中數字的比例。「小數位數」是小數點右側 (正) 或左側 (負) 的位數。比例範圍介於 -84 到 127 之間。

  • 格式：如果資料類型欄中的資料類型為 DATE 或其中一個 TIMESTAMP 類型，請從格式下拉式清單中選取該類型的格式。

預覽頁標

預覽頁籤中的載入預覽功能表會以列表化表單顯示來源資料。此顯示會反映您在特性區段中選擇的設定值。檔案功能表會顯示含有資料欄名稱的來源資料。

如果您將包含多個檔案的資料夾拖曳至資料連結資訊轉送站，然後按一下該卡片的 設定值 設定值，則預覽窗格會在窗格頂端包含預覽物件 (檔案) 下拉式清單，其中列出資料夾中的所有檔案。從該清單中選取要預覽的來源檔案。

表格頁籤

表格頁籤顯示連結資料之後，目標表格的外觀。

SQL 頁標

SQL 頁籤會顯示將執行以完成此資料連結工作的 SQL 命令。

附註：

即使在建立表格之前，您還是可以查看 SQL 程式碼。

關閉按鈕 - 儲存並關閉窗格

輸入資料連結工作的所有詳細資訊之後，請按一下頁面底端的關閉。這會儲存您輸入的詳細資訊，並返回「從雲端儲存體連結資料」窗格。

父項主題：連結至雲端儲存中的物件

執行資料連結工作

將資料來源新增至資料連結資訊轉送站，並輸入資料連結工作的相關詳細資料後，您便可執行此工作。

要執行職務：

  1. 如果您尚未這麼做，請按一下從雲端儲存連結資料窗格中的關閉按鈕，儲存您的設定值並關閉窗格。如果任一設定無效，則錯誤訊息會報告問題。修正問題並按一下關閉。

  2. 按一下資料連結購物車功能表列中的 開始 開始。若要停止資料連結工作，請按一下 停止 停止。

    當資料連結工作完成時，資料載入儀表板頁面會在表格與檢視載入區段底下顯示工作的結果。

    資料連結工作開始後，您可以在「資料載入」儀表板中檢視工作的進度。

父項主題：連結至雲端儲存中的物件

檢視執行資料連結工作之後的相關詳細資訊

您可以在「資料載入」儀表板上檢視工作的進度。

當資料載入工作完成時，「資料載入」儀表板頁面會顯示工作的結果。在表格載入的標頭頂端，您可以檢視表格名稱以及表格中的總資料欄。

按一下工作報表，即可檢視已順利處理的資料列總數和拒絕的資料列計數。您也可以檢視「開始時間」。「工作報表」的 SQL 窗格會顯示工作的同等 SQL 程式碼。

若要檢視工作中項目的相關資訊，請按一下「表格載入」上的動作圖示。

若要檢視載入作業的日誌，請按一下「記錄日誌」圖示。您可以儲存日誌、加以清除或重新整理。按一下確定以關閉日誌。

父項主題：連結至雲端儲存中的物件

檢視產生自資料連結工作的表格

執行資料連結工作後，您可以在「資料載入」儀表板上檢視資料連結工作所建立的表格。

修正資料載入工作。在資料載入工作後，您可能會看到想要更正的錯誤，或在檢查時，發現想要以不同的方式命名資料欄。在此情況下，按一下所選「資料表載入」上的重新載入選項，以從您最近的購物車重新載入卡片，然後按照您第一次嘗試前的操作方式進行編輯。「重新載入」圖示會使用工具建議的修正來重新載入來源資料。按一下「表格」標頭上的動作圖示，按一下表格並選取編輯，即可對資料載入工作進行任何變更 (亦即，變更資料欄名稱)。

父項主題：連結至雲端儲存中的物件