您可以選擇在客戶代管的執行個體上設定多個 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> |
將 BYOID Studio 載入至 iframe 的網址。 |
--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 檔案，用於說明內部分析連線，該連線會代管 system__activity 模型的資料。這個選項僅適用於讀取/複寫後端資料庫。 |
--internal-analytics-connection-pool-size=<i> |
可能執行系統活動模型查詢的同時資料庫連線數量。這個選項僅適用於讀取/複寫後端資料庫。 |
--internal-analytics-retention-days=<i> |
內部資料庫中保留記錄資料的天數。這不會影響任何 ETL 程序。預設值為 90。這個選項僅適用於讀取/複寫後端資料庫。 |
--k8s-deployment-api-s3bucket-url=<s> |
這個 Looker 程序可寫入 S3 值區憑證，並將其儲存為 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 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> |
限制每位使用者的並行查詢數量 (預設值：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 在正常運作時不需要取得 root 權限。基於安全考量，建議您在非 root 帳戶中執行 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 |
比較 Search Service 結果與舊版結果 (預設為 false)。 |
--search-service |
啟用 Search Service (預設值：false)。 |
--search-service-ab-test |
為 Search Service 啟用 AB 測試 (預設值：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以下是 SSL 供應器與 Looker 執行個體位於同一主機的範例：--ssl-provided-externally-by=localhost:443空值表示 Looker 應用程式伺服器提供 SSL。如果 Looker 執行個體在伺服器上執行，且該伺服器無法存取公開網際網路，您必須在內部網路中指定 Looker 執行個體伺服器可存取的 IP 位址。 |
--ssl-provided-externally |
已淘汰，請改用 --ssl-provided-externally-by。 |
--staging |
以測試版形式執行伺服器。這個選項可防止前置環境傳送定期報表。不過，如果排程任務發生任何問題，測試環境會繼續執行排程任務，並向排程計畫擁有者傳送錯誤電子郵件。 |
--staging-override-email=<s> |
將測試環境執行個體中的電子郵件傳送至這個地址，而非傳送至一般目的地。 |
--stereo-data-search-enabled |
啟用立體聲資料搜尋功能 (預設為 false)。 |
--studio-load-url=<s> |
用於將工作室載入至 iframe 的網址。 |
--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。