編寫和執行筆記本 - Amazon Redshift

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

編寫和執行筆記本

您可以使用筆記本在單一文件中組織、註釋和共用多個 SQL 查詢。您可以將多個 SQL 查詢和 Markdown 儲存格新增至筆記本。筆記本可讓您透過使用多個查詢和 Markdown 儲存格,將與資料分析相關聯的查詢和說明分組到單一文件中。您可以使用 Markdown 語法新增文字並設定外觀格式,以提供資料分析任務的內容和其他資訊。您可以與團隊成員共用筆記本。

若要使用筆記本,您必須將筆記本的許可新增至 IAM 主體 (IAM 使用者或 IAM 角色)。我們建議的最佳實務是,將許可政策附加到 IAM 角色,然後根據需要將其指派給使用者和群組。如需詳細資訊,請參閱 Amazon Redshift 中的身分和存取管理。您可以將許可新增至其中一個查詢編輯器 v2 受管政策。如需詳細資訊,請參閱存取查詢編輯器 v2

您可以循序執行筆記本的所有儲存格。筆記本的 SQL 查詢儲存格與查詢編輯器索引標籤的功能大多相同。如需詳細資訊,請參閱編寫和執行查詢。以下是查詢編輯器索引標籤與筆記本中的 SQL 儲存格之間的差異。

  • 沒有控制項可以在筆記本中的 SQL 陳述式上執行 Explain

  • 在筆記本中,每個 SQL 儲存格只能建立一個圖表。

您可以將筆記本匯出和匯入至使用查詢編輯器 v2 建立的檔案。檔案的副檔名為 .ipynb,檔案大小最多可以為 5 MB。SQL 和 Markdown 儲存格會存放在檔案中。叢集或工作群組與資料庫不會存放在匯出的筆記本中。當您開啟匯入的筆記本時,您要選擇叢集或工作群組,以及要在其中執行叢集或工作群組的資料庫。執行 SQL 儲存格之後,您便可以在結果索引標籤中選擇是否要將目前的結果頁面顯示為圖表。查詢的結果集不會存放在筆記本中。

當您使用全部執行執行以執行筆記本時,執行狀態面板就會變成可用的狀態。選擇 Run status 圖示開啟面板。此面板包含筆記本中 SQL 儲存格的最新全部執行執行狀態摘要。如果您執行多個 SQL 儲存格,您可以一目了然地檢視狀態、歷經時間以及有關執行的一些詳細資訊。您可以根據狀態篩選顯示的儲存格:AllSucceededErrorIn progressCanceled。您也可以使用此面板導覽至編輯器中的 SQL 儲存格。

若要建立筆記本
  1. 從導覽器功能表中選擇 Editor 編輯器

  2. 選擇 ,然後選擇筆記本

    根據預設,SQL 查詢儲存格會出現在筆記本中。

  3. 在 SQL 查詢儲存格中,執行以下其中一項操作:

    • 輸入查詢。

    • 貼上您複製的查詢。

  4. (選擇性) 選擇 New Markdown cell 圖示,然後選擇 Markdown 以新增 Markdown 儲存格,您可以在其中使用標準 Markdown 語法提供描述性或說明性的文字。

  5. (選擇性) 選擇 New SQL cell 圖示,然後選擇 SQL 以插入 SQL 儲存格。

您可以使用 Rename (鉛筆) 圖示重新命名筆記本。

More (更多) 功能表中,您也可以在筆記本上執行下列操作:

  • Share 與我的團隊共用 — 依標籤所定義與您的團隊共用筆記本。如需更多資訊,請參閱 共用查詢

  • Export 匯出 — 將筆記本匯出至副檔名為 .ipynb 的本機檔案。

  • Save 儲存版本 — 建立筆記本的版本。若要查看筆記本的版本,請導覽至已儲存的筆記本,然後開啟版本歷史記錄

  • Duplicate 複製 — 建立筆記本的副本,並在新的筆記本索引標籤中開啟它。

  • Shortcuts 捷徑 — 在編寫筆記本時顯示可用的捷徑。

開啟已儲存的筆記本
  1. 從導覽器功能表中選擇 Notebooks 筆記本。隨即會顯示您儲存的筆記本和筆記本資料夾。

  2. 選擇您想要開啟的筆記本,然後按兩下該筆記本。

您可以在筆記本索引標籤中顯示我的筆記本由我共用的筆記本,以及共用給我的團隊的筆記本。

若要將筆記本從本機檔案匯入我的筆記本,請選擇 Import 匯入,然後導覽至包含筆記本的 .ipynb 檔案。筆記本會匯入到目前開啟的筆記本資料夾。您接著可以在筆記本編輯器中開啟筆記本。

您可以從筆記本的內容功能表 (按一下滑鼠右鍵) 執行下列操作:

  • 開啟筆記本 — 在編輯器中開啟筆記本。

  • 儲存版本 — 儲存筆記本的版本。

  • 版本歷史記錄 — 顯示筆記本的版本。您可以從版本歷史記錄視窗中刪除和還原版本。您也可以從目前選取的版本建立筆記本。

  • 編輯標籤 — 在筆記本上建立和編輯標籤。

  • 與我的團隊共用 — 與您的團隊共用筆記本。

    若要與團隊共用筆記本,請確定您已將主體標籤 sqlworkbench-team 設定為與帳戶中其他團隊成員相同的值。例如,管理員可以針對會計部門中的每個人,將值設定為 accounting-team。如需範例,請參閱 要使用查詢編輯器 v2 所需的許可

  • 匯出 — 將筆記本匯出至本機檔案。

  • 重新命名 — 重新命名筆記本。

  • 複製 — 製作筆記本的副本。

  • 刪除 — 刪除筆記本。

如需筆記本的示範,請觀看下列影片。