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	以精靈身分執行 (預設值：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 <[e-mail]>)。
--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>	追蹤 ID，用於將網頁瀏覽資料傳送至其他 Google Analytics 追蹤程式。
-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 bucket 憑證寫入的網址，以 Kubernetes 密鑰的形式保留。
--load-chronicle-dialect	是否載入 Chronicle 內建方言 (預設：false)。
--log-format=<s>	記錄格式，可為 text 或 json (預設為 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 重新產生器的執行緒數量下限。
--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 主機名稱，這樣 Looker Action API 回呼 URI 就會使用 public_host_url 建構，而非 Looker 中的預設主機網址。啟動選項的輸入內容應為 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 分析人員要求疑難排解)，才使用以 root 身分執行的選項。
--redis-cache-config-file=<s>	包含 Redis 設定的檔案。
--regionalised-prod-byoid-studio-load-url=<s>	含有預留位置區域的 Prod URL，可在 iframe 中載入 BYOID 工作室。
--regionalised-prod-studio-load-url=<s>	Prod URL with placeholder region to load studio.
--regionalised-prod-studio-one-platform-endpoint=<s>	Studio One Platform API 的預留位置區域，用於正式版端點。
--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 的 KeyStore 檔案路徑。
--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>	將 Studio 載入 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)。
--url-flags-override	允許使用網址查詢參數覆寫功能旗標。
--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 開機指令碼會執行這個檔案，該指令碼隨附於 looker.jar。建議您在 lookerstart.cfg 檔案中設定 JAVAARGS 和 LOOKERARGS 的環境變數，因為安裝新版 Looker 開機指令碼時，這些變數不會遭到覆寫。

以下是 lookerstart.cfg 的範例，可停用 Looker 的 SSL，並將其設為在通訊埠 8080 執行：

LOOKERARGS="--no-ssl --port 8080"

變更 lookerstart.cfg 後，必須重新啟動 Looker。

後續步驟

設定 Looker 啟動選項後，即可設定 SSL 憑證，確保 HTTPS 正常運作。