您可以在客戶代管的執行個體上，選擇性設定多項 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)。 |
--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 |
關閉代管動作中心。 |
--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-analytics-retention-days=<i> |
在內部資料庫中保留記錄資料的天數。這不會影響任何 ETL 程序。預設值為 90。這個選項僅適用於唯讀副本後端資料庫。 |
--k8s-deployment-api-s3bucket-url=<s> |
這個 Looker 程序可將 S3 bucket 憑證寫入此網址，並以 Kubernetes 密鑰形式保存。 |
--log-format=<s> |
記錄檔格式為 text 或 json (預設為 text)。 |
--log-level=<s> |
記錄層級 (預設值：info)。 |
--log-to-file |
將記錄輸出傳送至 Looker 記錄檔 (預設值：true)。 |
--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 再生器的執行緒數量下限。 |
--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> |
限制每位使用者的並行查詢數量 (預設值：15)。 |
--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 主機名稱，這樣 Looker Action API 回呼 URI 就會以 public_host_url 而非 Looker 中的預設主機網址建構。啟動選項的輸入內容應為 https://<my.host.name>，網址中不得有尾端斜線。如果使用這個方法，Looker 管理員也必須將「透過動作中心共用資料」說明文件頁面中列出的靜態輸出 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 設定的檔案。 |
--report-backend-errors, --no-report-backend-errors |
回報後端錯誤 (預設值：false)。 |
--report-frontend-errors, --no-report-frontend-errors |
回報前端的錯誤 (預設：false)。注意：這個啟動選項已過時。請改用 client_monitor 功能旗標。 |
-S, --ssh-tunnel-sidecar-url=<s> |
用於連線至 SSH 通道伺服器 Sidecar 的基本網址。 |
--scheduled-job-attempt-limit=<i> |
排定工作嘗試次數上限 (預設值：10)。 |
--scheduled-job-max-age-days=<i> |
排定工作遭刪除前的最長保留時間 (預設值：60)。 |
--scheduler-query-limit=<i> |
限制並行排定查詢的數量 (預設值：10)。 |
--scheduler-query-timeout=<i> |
排程器逾時等待連線的時間長度 (預設值：1200)。 |
--scheduler-start-delay=<i> |
延遲工作執行器啟動的秒數 (預設值：60)。 |
--scheduler-threads=<i> |
同時排定的工作數 (預設值：10)。 |
--search-result-comparison |
比較「搜尋服務」結果與舊版結果 (預設：false)。 |
--search-service |
啟用「搜尋服務」 (預設值：false)。 |
--search-service-ab-test |
啟用「搜尋服務」的 A/B 測試 (預設：false)。 |
--self-signup |
允許任何人自行建立帳戶。 |
--shared-storage-dir=<s> |
網路檔案系統共用儲存空間的路徑。 |
--snowplow-host=<s> |
額外的 Snowplow 收集器。 |
--solr-basic-auth=<s> |
呼叫 Solr 的基本驗證憑證 (預設值：solr:SolrRocks)。 |
--ssl |
使用 SSL (預設值：true)。 |
--ssl-ca-cert=<s> |
已淘汰，請改用 --ssl-keystore。 |
--ssl-cert=<s> |
已淘汰，請改用 --ssl-keystore。 |
--ssl-key=<s> |
已淘汰，請改用 --ssl-keystore。 |
--ssl-keystore-pass-file=<s> |
內含 ssl-keystore 密碼的檔案路徑。 |
--ssl-keystore-pass=<s> |
ssl-keystore 檔案的密碼。 |
--ssl-keystore=<s> |
安全資料傳輸層 (SSL) 的金鑰儲存區檔案路徑。 |
--ssl-provided-externally-by=<s> |
提供外部 SSL 供應商的主機：連接埠，可從執行 Looker 的伺服器存取。如果未指定，Looker 應用程式伺服器會提供 SSL。以下是 Looker 叢集前端的 SSL Proxy 範例：--ssl-provided-externally-by=192.168.123.13:443以下是與 Looker 執行個體位於同一主機的 SSL 供應商範例：--ssl-provided-externally-by=localhost:443空值表示 Looker 應用程式伺服器提供 SSL。如果 Looker 執行個體在伺服器上執行，且該伺服器限制存取公開網際網路，您必須在內部網路上指定一個 IP 位址，供 Looker 執行個體伺服器存取。 |
--ssl-provided-externally |
已淘汰，請改用 --ssl-provided-externally-by。 |
--staging |
以暫存形式執行伺服器。這個選項可防止測試執行個體傳送定期報表。不過，如果排定工作發生任何問題，預先發布的執行個體仍會繼續執行排定工作，並向排定計畫擁有者傳送錯誤電子郵件。 |
--staging-override-email=<s> |
將測試執行個體上的電子郵件傳送到這個地址，而不是正常目的地。 |
--stereo-data-search-enabled |
啟用立體資料搜尋功能 (預設值：false)。 |
--studio-load-url=<s> |
在 iframe 中載入 YouTube 工作室的網址。 |
--studio-one-platform-endpoint=<s> |
Studio One Platform API 的端點。 |
--task-monitor-abandoned-query-in-seconds=<i> |
自上次存取工作後經過的時間長度，超過這個時間長度即視為放棄查詢工作。 |
--task-monitor-query-startup-interval-in-seconds=<i> |
查詢開始執行到第一次發生長時間輪詢之間，這段時間會做為寬限期。讓來電者有更多時間準備，再開始進行投票。 |
--task-monitor-sleep-interval-in-seconds=<i> |
工作追蹤執行緒可檢查工作是否已捨棄前的休眠間隔。 |
--unification-jwt-service-account=<s> |
Unification JWT 服務帳戶。 |
--unlimited-scheduler-threads=<i> |
可同時執行的無上限排定工作數量 (預設為 3)。 |
--use-custom-jdbc-config |
是否使用自訂 JDBC 驅動程式設定 (預設值：false)。 |
--user-db-credentials |
使用限制。連線可以採用個別使用者的憑證 (預設值：false)。 |
-v, --version |
列印版本並結束。 |
憑證檔案格式
如果已將應用程式資料庫變更為 MySQL，您需要名為 looker-db.yml 的憑證檔案，其中包含下列設定：
dialect: mysql
host: YOUR_HOSTNAME
username: YOUR_USERNAME
password: YOUR_PASSWORD
database: YOUR_DBNAME
port: YOUR_PORT
如果 MySQL 資料庫需要 SSL 連線，looker-db.yml 檔案也必須包含下列項目：
ssl: true
永久保留啟動選項
如要永久設定啟動設定，建議在 Looker 應用程式目錄中建立名為 lookerstart.cfg 的檔案。這個檔案會由 looker.jar 提供的 Looker 啟動指令碼執行。建議您在 lookerstart.cfg 檔案中設定 JAVAARGS 和 LOOKERARGS 的環境變數，因為安裝新版 Looker 啟動指令碼時，這些變數不會遭到覆寫。
以下是 lookerstart.cfg 的範例，可停用 Looker 的 SSL，並將其設為在通訊埠 8080 上執行：
LOOKERARGS="--no-ssl --port 8080"
變更 lookerstart.cfg 後，必須重新啟動 Looker。
後續步驟
設定 Looker 啟動選項後，即可設定 SSL 憑證，確保 HTTPS 正常運作。