資料整合執行時命令列 (DIRCTL) 是一個 .基於 NET 的命令列介面 (CLI) 自動化 Kubernetes 叢集內資料整合執行時管理的工具。 它簡化複雜的 Kubernetes 操作，指令簡單明瞭，並確保與 Microsoft Purview 的安全通訊以進行註冊及憑證生命週期管理。
若要在本地管理您的 Microsoft Purview Kubernetes 自架資料整合執行環境，您需要 DIRCTL 命令列工具。 您可以在資料整合執行時建立過程中下載此工具。 請參閱下方 Windows 與 Linux 作業系統的設定說明。
Windows 設定用於 DIRCTL CLI
- 下載 並安裝 Kubectl CLI 工具。
- 依照此路徑將產生的 kube 設定檔放入使用者專用資料夾中：
C:/Users/<user-folder>/.kube/。 複製檔案並命名為 設定。注意事項
此設定檔是 Kubernetes 叢集中 DIRCTL 認證所必需的。
- 下載 Windows 版 DIRCTL CLI 套件 .zip。
- 將內容解壓到你本機的偏好目錄。
- 在 Windows 上開啟終端機。
- 導覽到已解壓的 DIRCTL 目錄。
- 用 CD 指令
<path-to-dirctl>移動到資料夾裡。 - 請使用
./DIRCTL 執行指令。
DIRCTL CLI 的 Linux 設定
- 下載並安裝 Linux 發行版的 kubectl CLI。
- 將 kubeconfig 檔案（用於 Kubernetes 認證）放在預設的 kube 資料夾中：
~/.kube/。 - 將你產生的 kubeconfig 檔案複製到使用者專屬的目錄。 請確保檔案名稱為 config：
mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config注意事項
此設定檔是 Kubernetes 叢集中 DIRCTL 認證所必需的。
- 下載 Windows 或 Linux 的 DIRCTL CLI 套件。
- 開啟終端機並導覽到 DIRCTL 目錄：
cd /your/target/directory/DIRCTL - 執行指令時使用：
./DIRCTL。
DIRCTL 指令
DIRCTL 說明：說明指令提供 DIRCTL 工具中所有可用指令與功能的全面概述。 它確保你能有效使用工具，提供資料整合任務的指導與背景。
DIRCTL 重新註冊：
./DIRCTL re-register –registration-key <re-registration-key-value>若現有的資料整合執行時資源長時間不活躍，使用新的註冊金鑰重新註冊 Re-register 指令。DIRCTL 刪除：
./DIRCTL delete當你想從系統中取消資料整合執行時並釋放所有相關的應用程式 Kubernetes Pods，使用 Delete 指令提供一個簡化的解決方案。 此指令會完全移除 DQS) SQL Server 資料品質服務 (DIR，確保執行時或其應用程式 Pod 的殘餘不存在。 此指令同時負責終止所有與 DIR 應用程式相關的運行 Kubernetes Pods，釋放系統內的資源。DIRCTL 升級：
./DIRCTL upgrade –v <image version>升級指令允許您無縫地將資料整合執行時版本升級至使用者指定的最新可用版本。 此流程確保資料整合執行時配備最新功能、增強功能及安全修補程式，維持系統內的相容性與效率。DIRCTL 描述：
./DIRCTL describeDescribe 指令提供對執行中的 DIR 與 DIRCTL 應用程式狀態與效能的詳細洞察。 它會檢查應用程式的健康狀況，確保任何問題或異常能被迅速發現。 透過提供執行環境的可視化，此功能支援故障排除與主動系統維護。DIRCTL 日誌：
./DIRCTL log download –d <relative-destination-folder-path>使用 Log 指令將所有活躍資料整合執行時應用程式 Pods 的日誌下載到指定的目的地資料夾路徑中。 此功能對於除錯、效能監控或稽核活動尤其重要，因為它確保您能取得詳細的執行時紀錄。 透過完整記錄，您能有效識別模式、異常與潛在問題，成為系統維護與優化的重要工具。DIRCTL 設定：
./DIRCTL config auto-update-enable <true/false>將自動更新啟用的設定更新為 false 或 true。