Looker 啟動選項

在客戶託管的執行個體上,您可以選擇設定多項 Looker 啟動設定。如不需要變更這些選項,可以略過並啟動 Looker。

啟動選項清單

下表列出目前可用的啟動選項 (按字母順序排列)。您也可以使用 --help 選項執行 Looker 開機指令碼,顯示啟動選項清單。

選項 說明
--alerts-scheduler-threads=<i> 同時排定快訊的數量 (預設值:3)。
--ami 已淘汰,請改用 --marketplace=aws
--api-server-max-threads=<i> Puma API 伺服器的執行緒數量上限。
--api-server-min-threads=<i> Puma API 伺服器的執行緒數量下限。
--application-server-max-threads=<i> Puma 應用程式伺服器的執行緒數量上限。
--application-server-min-threads=<i> Puma 應用程式伺服器的執行緒數量下限。
--apply-db-migrations 在啟動時套用資料庫遷移作業。只有在分別套用遷移作業時才停用 (預設值:true)。
--async-results-cache-time=<i> 保留非同步結果快取的時間長度 (預設值:300)。
--byoid-studio-load-url=<s> 在 iframe 中載入 BYOID Studio 的網址。
--cdn-hosts=<s> CDN 集區的主機名稱 (以半形逗號分隔,預設值為 static-a.lookercdn.com,static-b.lookercdn.com)。
--cipher-key-file=<s> 含有密碼編譯金鑰的檔案路徑 (僅適用於舊版加密)。
--cloud-trace-enabled 使用預設憑證或 JSON 憑證啟用追蹤功能 (如果使用 --cloud-trace-json-file 提供,預設為 false)。
--cloud-trace-json-file=<s> 包含服務帳戶憑證的 JSON 檔案,用於將追蹤資料上傳至 Google Cloud Trace。
--cloud-trace-project-id=<s> 要將追蹤記錄資料上傳至的 Google 專案 ID。
--cloud-trace-sample-rate=<f> 取樣追蹤記錄的速率 (0 到 1,預設值為 0.0)。
--clustered 這個伺服器是否為叢集的一部分 (預設值:false)。
--concurrent-render-caching-jobs=<i> 同時進行的算繪快取程序數量 (預設值:3)。
--concurrent-render-jobs=<i> 同時執行的 PhantomJS 或 Chromium 算繪程序數量 (預設值:2)。
--core-on-loopback 在迴路介面上公開 Core API (預設值:false)。
--core-port=<i> 執行核心的通訊埠 (預設為 19999)。
--customer-artifact-maxsize=<i> 客戶構件儲存庫的大小上限 (MB)。
-d, --internal-db-creds=<s> 含有資料庫憑證的 YAML 檔案路徑。
--daemonize 以 Daemon 形式執行 (預設值:true)。
--db-migrations-kill-timeout=<i> 資料庫遷移作業的終止逾時時間 (以秒為單位,預設值為 480)。
--db-migrations-lock-wait-timeout=<i> 資料庫遷移作業的鎖定等待逾時時間 (以秒為單位,預設值為 180)。
--db-migrations-monitor-cutoff=<i> 監控內部資料庫遷移作業的截止時間 (以秒為單位,預設值為 2592000)。
--db-migrations-wait-timeout=<i> 資料庫遷移作業的等待逾時時間 (以秒為單位,預設值為 720)。
--default-mailer-domain=<s> 預設郵件寄件者網域。
--default-mailer-fromemail=<s> 預設郵件程式傳送電子郵件時使用的電子郵件地址 (預設值:Looker <noreply@lookermail.com>)。
--default-mailer-host=<s> 預設郵件寄件者主機名稱 (預設值:smtp.sendgrid.net)。
--default-mailer-password=<s> 預設郵件程式密碼 (不建議使用指令列上的密碼)。
--default-mailer-port=<i> 預設郵件程式通訊埠 (預設值:587)。
--default-mailer-username=<s> 預設郵件寄件者使用者名稱。
--disable-db-log 停用內部資料庫查詢記錄 (預設值:false)。
--dogstatsd-host-ip=<s> Datadog statsd 伺服器主機 IP。
--dogstatsd-host-port=<i> Datadog 伺服器主機通訊埠。
-e, --help 顯示啟動選項清單。
--enable-blobstore-recryption 在重新產生金鑰作業中啟用 Blobstore 持續重新加密 (預設值:false)。
--error-emails-to=<s> 錯誤電子郵件傳送至 <email address>
--experimental-features=<s> 允許的實驗性功能清單 (以半形逗號分隔)。
--experimental-routes=<s> 以半形逗號分隔的清單,列出允許的實驗性路徑,這些路徑會產生帶有 -next 後置字串的路徑。
--extension-load-url=<s> 將擴充功能載入安全 iframe 的網址。
--external-solr-enabled 啟用外部 Solr (而非預設的內嵌 Solr) (預設值:false)。
--fips 啟用 FIPS-140 加密 (預設:false)。
--force-cdn 強制啟用 CDN (預設值:false)。
--force-cipher-key 忽略密碼金鑰設定的防護措施 (僅適用於舊版加密,預設值:false)。
--force-enable-pendo 在自有品牌執行個體或嵌入環境中啟用 Pendo 指南 (預設:false)。
--force-error-emails 強制 Looker 使用電子郵件回報錯誤 (預設值:false)。
--force-gcm-encryption 已淘汰 (不再需要這個選項)。
--force-mismatched-internal-db 允許使用不同步的 Looker 內部資料庫 (預設值:false)。
--force-no-cdn 強制停用 CDN (預設值:false)。
--git-hooks-use-local-path 請使用 git_hooks 目錄的本機路徑,而非共用儲存空間。
--git-performance-logging 啟用 JGit 效能記錄 (預設值:false)。
--google-analytics-tracker-id=<s> 用於將網頁瀏覽資料傳送至其他 Google Analytics 追蹤器的追蹤 ID。
-h, --hosted 由 Looker 代管。
-H, --hostname=<s> 節點對節點通訊的主機名稱。
--hosted-action-hub-disabled 關閉 Action Hub 代管。
--in-memory-cache-size=<i> 記憶體快取的大小 (以 MB 為單位),預設為 200。
--integration-proxy-cert=<s> 整合 Proxy PKI 憑證檔案的路徑。
--integration-proxy-key=<s> 整合 Proxy PKI 金鑰檔案的路徑。
--internal-analytics-connection-file=<s> YAML 檔案,用於說明內部 Analytics 連線,該連線會代管 system__activity 模型的資料。這個選項僅適用於唯讀副本後端資料庫。
--internal-analytics-connection-pool-size=<i> 可執行系統活動模型查詢的並行資料庫連線數。這個選項僅適用於唯讀副本後端資料庫。
--internal-data-apps-on-gcs 允許資料應用程式擴充功能從 Google Cloud Storage 擷取執行階段資產 (僅限內部/Google 員工)。
--internal-analytics-retention-days=<i> 在內部資料庫中保留記錄資料的天數。這不會影響任何 ETL 程序。預設值為 90。這個選項僅適用於唯讀副本後端資料庫。
--k8s-deployment-api-s3bucket-url=<s> 這個 Looker 程序可將 S3 值區憑證寫入此網址,並以 Kubernetes 密鑰形式保存。
--load-chronicle-dialect 是否載入 Chronicle 內建方言 (預設值:false)。
--log-format=<s> 記錄檔格式,可以是 textjson (預設為 text)。
--log-frontend-errors 將前端的錯誤詳細資料記錄到顧客的記錄檔 (預設:false)。
--log-level=<s> 記錄層級 (預設值:info)。
--log-to-file 將記錄輸出內容傳送至 Looker 記錄檔 (預設為 true)。
--lookerdb-query-timeout=<i> Looker 內部資料庫查詢的逾時值 (以毫秒為單位,預設值為 0)。
--lookml-runtime-cache-size=<i> LookML 執行階段快取的大小 (以 MB 為單位),預設為 200。
--loose-cipher-key-file 不要要求密碼金鑰檔案的 0600 權限 (僅限舊版加密,預設值:false)。
--marketplace=<s> 在 Looker Marketplace 執行個體中執行。
--max-async-threads=<i> 非同步查詢執行緒數量上限 (預設值:200)。
--max-configurable-db-connections=<i> 使用者介面中允許的客戶資料庫連線數上限。
--max-db-connections-records=<i> db_connection 表格中允許的連線記錄數上限 (預設值:10000)。
--max-pdt-regen-threads=<i> PDT 重新產生器執行緒數量上限。
--max-scheduled-plans=<i> 有效週期性排定方案的數量上限 (預設值:unlimited)。
--max-scheduler-jitter-in-seconds=<i> 這個旗標可將排程執行作業隨機延遲指定的秒數。
--max-unstreamed-limit=<i> 設定所有「非串流」查詢可傳回的資料列數量上限 (預設值:100,000)。
--min-pdt-regen-threads=<i> PDT Regenerator 的執行緒數量下限。
--monitoring-port=<i> 用於代管監控 (Prometheus 等) 的連接埠 (預設為 1552)。
-n, --node-to-node-port=<i> 節點對節點通訊的通訊埠 (預設值:1551)。
--new-cipher-key-file=<s> 包含新密碼金鑰的檔案路徑 (僅適用於舊版加密)。
--on-disk-cache-size=<i> 磁碟快取大小 (MB) (預設值:2000)。
-p, --port=<i> 要執行的通訊埠 (預設:9999)。
--per-user-query-limit=<i> 限制每個使用者、每個連線和 Looker 執行個體上每個節點的並行查詢數量 (預設值:15)。如果連線的「這個連線的個別使用者並行查詢數量上限」設定提供值,則「這個連線的個別使用者並行查詢數量上限」值會覆寫連線的 per-user-query-limit。請注意,「這個連線的個別使用者並行查詢數量上限」設定是針對每個使用者和每個連線,而非每個節點。詳情請參閱「將 Looker 連線至資料庫」說明文件頁面。
--per-user-query-timeout=<i> 等待連線的每個使用者逾時長度 (預設值:600)。
--prefer-ipv4 偏好使用 IPv4。
--public-embed-auth-param-file=<s> 公開驗證的驗證參數檔案。
--public-host-url=<s> 如果啟用 public_host_url 授權功能,管理員就能指定 public_host_url 主機名稱,這樣一來,系統就會使用 public_host_url 而非 Looker 中的預設主機網址,建構 Looker Action API 回呼 URI。啟動選項的輸入內容應為 https://,網址中不得有尾端斜線。如果使用這個方法,Looker 管理員也必須將透過 Action Hub 共用資料說明頁面列出的靜態輸出 IP 位址加入許可清單。
-q, --queue-broker-port=<i> 佇列代理程式的通訊埠 (預設為 61616)。
--qm-long-poll-max-sleep-interval-in-seconds=<f> 長輪詢 API 檢查結果是否可用的最長休眠間隔 (預設值:1)。
--qm-long-poll-sleep-interval-in-seconds=<i> 在長輪詢 API 檢查結果是否可用之前,初始休眠間隔 (預設值:0.1)。
--qm-long-poll-timeout-in-seconds=<i> 在傳回用戶端之前,長輪詢 API 的伺服器端逾時時間上限 (預設值:30)。
--query-manager-max-threads=<i> 查詢管理員的執行緒數量上限。
--query-manager-min-threads=<i> 查詢管理員的執行緒數量下限。
--query-metrics-retention-hours=<i> 在內部資料庫中保留 query_metrics 資料的小時數 (預設值:336)。
--queue-startup-timeout-in-seconds=<i> 允許在啟動時連線至佇列的時間長度 (以秒為單位),預設值為 180 秒。
--query-task-cleanup-interval-seconds=<i> 查詢工作表清除作業之間的間隔 (預設值:600)。
--query-task-persistence-duration-minutes=<i> 查詢完成後,將資料列保留在查詢工作資料表中的時間長度 (預設值:360)。
-r, --root 允許以超級使用者身分執行。

Looker 的正常運作不需要根層級權限。基於安全考量,建議您在非根帳戶中執行 Looker。只有在必要時才使用以根身分執行的選項,例如 Looker 分析師要求您這麼做,以便進行疑難排解。
--redis-cache-config-file=<s> 包含 Redis 設定的檔案。
--regionalised-prod-byoid-studio-load-url=<s> 含有預留位置區域的正式版網址,可在 iframe 中載入 BYOID 工作室。
--regionalised-prod-studio-load-url=<s> 含有預留位置區域的正式版網址,用於載入 Studio。
--regionalised-prod-studio-one-platform-endpoint=<s> Studio One Platform API 的正式版端點,其中包含預留位置區域。
--report-backend-errors, --no-report-backend-errors 回報後端錯誤 (預設值:false)。