尋找 Amazon Timestream for InfluxDB 資料庫執行個體的連線資訊資料庫身分驗證選項使用參數群組

連線至 Amazon Timestream for InfluxDB 資料庫執行個體

您必須先建立資料庫執行個體，才能連線到資料庫執行個體。如需相關資訊，請參閱建立資料庫執行個體。在 Amazon Timestream 佈建資料庫執行個體之後，請使用 InfluxDB API、influx CLI 或任何相容的用戶端或公用程式，讓 InfluxDB 連線至資料庫執行個體。

主題

尋找 Amazon Timestream for InfluxDB 資料庫執行個體的連線資訊
資料庫身分驗證選項
使用參數群組

尋找 Amazon Timestream for InfluxDB 資料庫執行個體的連線資訊

資料庫執行個體的連線資訊包括其端點、連接埠、使用者名稱、密碼和有效的存取字符，例如運算子或全存取字符。例如，對於 Timestream for InfluxDB 資料庫執行個體，假設端點值為 c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws。在此情況下，連接埠值為 8086，資料庫使用者為 admin。根據此資訊，若要存取您將使用的執行個體：

執行個體的端點 c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws:8086。
建立執行個體時提供的使用者名稱和密碼，或是有效的存取權杖。

在 2024 年 12 月 9 日之前建立的執行個體會有端點，其中包含執行個體名稱而非執行個體 ID。例如：influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com。

重要

作為資料庫執行個體回應物件的一部分，您將會收到 influxAuthParametersSecretArn。這將保留您帳戶中 Secrets Manager 秘密的 ARN。只有在您的 InfluxDB 資料庫執行個體可用之後才會填入 t。秘密包含CreateDbInstance程序期間提供的 Influx 身分驗證參數。這是唯讀複本，因為此秘密的任何updates/modifications/deletions不會影響建立的資料庫執行個體。如果您刪除此秘密，我們的 API 回應仍會參考已刪除的秘密 ARN。

每個資料庫執行個體的端點都是唯一的，連接埠和使用者的值可能會有所不同。若要連線至資料庫執行個體，您可以使用 influx CLI、InfluxDB API 或與 InfluxDB 相容的任何用戶端。

若要尋找資料庫執行個體的連線資訊，請使用 AWS 管理主控台。您也可以使用 AWS Command Line Interface (AWS CLI) describe-db-instances命令或 Timestream for InfluxDB API GetDBInstance操作。

使用 AWS Management Console

登入 AWS Management Console 並開啟 Amazon Timestream 主控台。
在導覽窗格中，選擇 InfluxDB 資料庫以顯示資料庫執行個體的清單。
選擇資料庫執行個體的名稱以顯示其詳細資訊。
在摘要區段中，複製端點。另外，請記下連線埠號碼。您需要端點和連接埠號碼才能連線到資料庫執行個體。

如果您需要尋找使用者名稱和密碼資訊，請選擇組態詳細資訊索引標籤，然後選擇 influxAuthParametersSecretArn以存取 Secrets Manager。

使用 CLI

若要使用尋找 InfluxDB 資料庫執行個體的連線資訊 AWS CLI，請呼叫 get-db-instance命令。在呼叫中，查詢資料庫執行個體 ID、端點、連接埠和 influxAuthParametersSecretArn。

若為 Linux、macOS 或 Unix：
```
aws timestream-influxdb get-db-instance --identifier id \
 --query "[name,endpoint,influxAuthParametersSecretArn]"
```
針對 Windows：
```
aws timestream-influxdb get-db-instance --identifier id ^
 --query "[name,endpoint,influxAuthParametersSecretArn]"
```
輸出內容應如下所示：若要存取使用者名稱資訊，您需要檢查 InfluxAuthParameterSecret。
```
[
    [
        "mydb",
        "mydbid-123456789012.timestream-influxdb.us-east-1.on.aws",
        8086,
    ]
]
```

建立存取權杖

透過此資訊，您將能夠連線至執行個體，以擷取或建立您的存取字符。有幾種方法可以達成此目標：

使用 CLI

如果您尚未下載、安裝和設定注入 CLI。

設定流入 CLI 組態時，請使用 --username-password進行驗證。


influx config create --config-name YOUR_CONFIG_NAME --host-url "https://yourinstanceid-accountidentifier.timestream-influxdb.us-east-1.on.aws:8086" --org yourorg --username-password admin --active

使用 influx auth create 命令來重新建立您的運算子字符。請注意，此程序會使舊的運算子字符失效。
```
influx auth create --org kronos --operator
```
擁有運算子字符後，您可以使用 influx 身分驗證清單命令來檢視所有字符。您可以使用 influx 驗證建立命令來建立全存取字符。

重要

您需要執行此步驟，才能先取得您的運算子字符。然後，您將可以使用 InfluxDB API 或 CLI 建立新的權杖。

使用 InfluxDB UI

使用建立的端點瀏覽至 Timestream for InfluxDB 執行個體，以登入和存取 InfluxDB UI。您需要使用用來建立 InfluxDB 資料庫執行個體的使用者名稱和密碼。您可以從 influxAuthParametersSecretArn回應物件中指定的擷取此資訊CreateDbInstance。

或者，您可以從 Amazon Timestream for InfluxDB 主控台開啟 InfluxDB UI：
1. 登入 AWS Management Console ，並在 https：// 開啟 Timestream for InfluxDB 主控台。 https://console.aws.amazon.com/timestream/
2. 在 Amazon Timestream for InfluxDB 主控台的右上角，選擇您在其中建立資料庫執行個體 AWS 的區域。
3. 在資料庫清單中，選擇 InfluxDB 執行個體的名稱以顯示其詳細資訊。在右上角，選擇 InfluxDB UI。
登入 InfluxDB UI 後，請使用左側導覽列導覽至載入資料，然後導覽至 API 權杖。
選擇產生 API 權杖，然後選取所有存取 API 權杖。
輸入 API 字符的描述，然後選擇儲存。
複製產生的字符並存放它以安全保存。

重要

從 InfluxDB UI 建立權杖時，新建立的權杖只會顯示一次。請務必複製這些項目。否則，您將需要重新建立它們。

使用 InfluxDB API

使用 POST 請求方法將請求傳送至 InfluxDB API /api/v2/authorizations端點。

在您的請求中包含下列項目：
1. 標頭：
  1. 授權：權杖 <INFLUX_OPERATOR_TOKEN>
  2. Content-Type：Application/json
2. 請求內文：具有下列屬性的 JSON 內文：
  1. 狀態：「作用中」
  2. 描述：API 字符描述
  3. orgID：InfluxDB 組織 ID
  4. 許可：物件陣列，其中每個物件代表 InfluxDB 資源類型或特定資源的許可。每個許可都包含下列屬性：
    1. 動作：「讀取」或「寫入」
    2. 資源：JSON 物件，代表要授予許可的 InfluxDB 資源。每個資源至少包含下列屬性：orgID：InfluxDB 組織 ID
    3. 類型：資源類型。如需 InfluxDB 資源類型的相關資訊，請使用 /api/v2/resources 端點。

下列範例使用 curl和 InfluxDB API 來產生全存取字符：


export INFLUX_HOST=https://instanceid-123456789.timestream-influxdb.us-east-1.on.aws
export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID>
export INFLUX_TOKEN=<YOUR_INFLUXDB_OPERATOR_TOKEN>

curl --request POST \
"$INFLUX_HOST/api/v2/authorizations" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --header "Content-Type: text/plain; charset=utf-8" \
  --data '{
    "status": "active",
    "description": "All access token for get started tutorial",
    "orgID": "'"$INFLUX_ORG_ID"'",
    "permissions": [
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}}
    ]
  }
'

資料庫身分驗證選項

Amazon Timestream for InfluxDB 支援下列方式來驗證資料庫使用者：

密碼身分驗證 – 您的資料庫執行個體會執行使用者帳戶的所有管理。您可以使用 InfluxDB UI、Influx CLI 或 InfluxDB API 來建立使用者、指定密碼和管理權杖。
權杖身分驗證 – 資料庫執行個體會執行使用者帳戶的所有管理。您可以透過 influx CLI 和 InfluxDB API，使用運算子字符來建立使用者、指定密碼和管理字符。

加密的連線

您可以從應用程式使用 Secure Socket Layer (SSL) 或 Transport Layer Security (TLS) 來加密與資料庫執行個體的連線。InfluxDB 與 Kronos 服務建立和管理的應用程式之間 TLS 交握所需的憑證。續約憑證時，執行個體會自動更新為最新版本，而不需要任何使用者介入。

使用參數群組

資料庫參數指定資料庫的配置方式。例如，資料庫參數可以指定要配置給資料庫的資源量 (例如記憶體)。

您可以透過將資料庫執行個體與參數群組建立關聯來管理資料庫組態。Amazon Timestream for InfluxDB 使用預設設定定義參數群組。您也可以使用自訂設定，定義自己的參數群組。

參數群組概觀

資料庫參數群組扮演引擎組態值的容器，以套用至一或多個資料庫執行個體。

預設和自訂參數群組

資料庫執行個體會使用資料庫參數群組。以下各節介紹資料庫執行個體參數群組的設定和管理。

建立資料庫參數群組

您可以使用 AWS Management Console、 AWS Command Line Interface或 Timestream API 建立新的資料庫參數群組。

下列限制適用於資料庫參數群組名稱：

名稱必須為 1 到 255 個字母、數字或連字號。
預設參數群組名稱可以包括句點，例如 default.InfluxDB.2.7。不過，自訂參數群組名稱不能包括句點。
第一個字元必須是字母。
名稱開頭不可為「dbpg-」
名稱不能以連字號結尾或包含兩個連續連字號。
如果您在未指定資料庫參數群組的情況下建立資料庫執行個體，資料庫執行個體會使用 InfluxDB 引擎預設值。

您無法修改預設參數群組的參數設定。相反地，您可以執行下列作業：

建立新的參數群組。
變更所需參數的設定。並非參數群組中的所有資料庫引擎參數都有資格進行修改。
更新您的資料庫執行個體以使用自訂參數群組。如需更新資料庫執行個體的詳細資訊，請參閱更新資料庫執行個體。

注意

如果您已將資料庫執行個體修改為使用自訂參數群組，且啟動資料庫執行個體，則 Amazon Timestream for InfluxDB 會在啟動程序中自動重新啟動資料庫執行個體。

目前，一旦建立自訂參數群組，您將無法對其進行修改。如果您需要變更參數，您必須建立新的自訂參數群組，並將其指派給需要此組態變更的執行個體。如果您更新現有的資料庫執行個體以指派新的參數群組，一律會立即套用並重新啟動執行個體。

靜態和動態資料庫執行個體參數

InfluxDB 資料庫執行個體參數一律為靜態。其行為如下：

當您變更靜態參數、儲存資料庫參數群組，並將其指派給執行個體時，參數變更會在執行個體重新啟動後自動生效。

當您將新的資料庫參數群組與資料庫執行個體建立關聯時，Timestream 只會在資料庫執行個體重新啟動後套用修改後的靜態參數。目前唯一選項會立即套用。

如需變更資料庫叢集參數群組的詳細資訊，請參閱更新資料庫執行個體。

支援的參數和參數值

若要判斷資料庫執行個體支援的參數，請檢視資料庫執行個體所使用的資料庫參數群組中的參數。如需詳細資訊，請參閱檢視資料庫參數群組的參數值。

如需 InfluxDB 開放原始碼版本支援的所有參數的詳細資訊，請參閱 InfluxDB 組態選項。目前您只能修改下列 InfluxDB 參數：

參數	描述	預設值	Value	有效範圍	注意
flux-log-enabled	包含顯示 Flux 查詢詳細日誌的選項	FALSE	Boolean	N/A
日誌層級	記錄輸出層級。InfluxDB 會輸出嚴重性層級大於或等於指定層級的日誌項目。	info	除錯、資訊、錯誤	N/A
無任務	停用任務排程器。如果有問題的任務阻止 InfluxDB 啟動，請使用此選項啟動 InfluxDB，而無需排程或執行任務。	FALSE	Boolean	N/A
query-concurrency	允許同時執行的查詢數目。將設定為 0 允許無限數量的並行查詢。	1,024		N/A
query-queue-size	執行佇列中允許的查詢數目上限。達到佇列限制時，會拒絕新的查詢。將設為 0 允許佇列中不限數量的查詢。	1,024		N/A
tracing-type	在 InfluxDB 中啟用追蹤，並指定追蹤類型。預設會停用追蹤。	""	log、jaeger	N/A
停用指標	停用公開內部 InfluxDB 指標的 HTTP /metrics 端點。	FALSE		N/A
http-idle-timeout	在等待新請求時，伺服器應保持已建立連線的最長持續時間。設為 `0` 表示沒有逾時。	3 公尺0 秒	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	小時： -下限：0 -上限：256，205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
http-read-header-timeout	伺服器應嘗試讀取新請求 HTTP 標頭的持續時間上限。設為 `0` 表示沒有逾時。	10 秒	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	小時： -下限：0 -上限：256，205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
http-read-timeout	伺服器應嘗試讀取整個新請求的最大持續時間。設為 `0` 表示沒有逾時。	0	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	小時： -下限：0 -上限：256，205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
http-write-timeout	伺服器應花費處理和回應寫入請求的最大持續時間。設為 `0` 表示沒有逾時。	0	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	小時： -下限：0 -上限：256，205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
influxql-max-select-buckets	`SELECT` 陳述式可以建立的依時間儲存貯體的群組數量上限。 `0` 允許無限數量的儲存貯體。	0	Long	下限：0 上限：9，223，372，036，854，775，807
influxql-max-select-point	`SELECT` 陳述式可處理的點數上限。 `0` 允許無限的點數。InfluxDB 每秒檢查點計數（因此超過最大值的查詢不會立即中止）。	0	Long	下限：0 上限：9，223，372，036，854，775，807
influxql-max-select-series	`SELECT` 陳述式可以傳回的序列數量上限。 `0` 允許不限數量的序列。	0	Long	下限：0 上限：9，223，372，036，854，775，807
pprof-disabled	停用 `/debug/pprof` HTTP 端點。此端點提供執行時間分析資料，在偵錯時非常有用。	TRUE	Boolean	N/A	雖然 InfluxDB `false` 預設會將 pprof-disabled 設為，但 `true` 預設會將 pprof-disabled AWS 設為。
query-initial-memory-bytes	為查詢配置的初始記憶體位元組。	0	Long	下限：0 上限： query-memory-bytes
query-max-memory-bytes	查詢允許的記憶體總位元組數上限。	0	Long	下限：0 上限：9，223，372，036，854，775，807
query-memory-bytes	指定新建立的使用者工作階段的存留時間 (TTL)，以分鐘為單位。	0	Long	下限：0 上限：2，147，483，647	必須大於或等於 query-initial-memory-bytes。
工作階段長度	指定新建立的使用者工作階段的存留時間 (TTL)，以分鐘為單位。	60	Integer	下限：0 上限：2，880
session-renew-disabled	在每個請求上停用自動擴展使用者的工作階段 TTL。根據預設，每個請求都會將工作階段的過期時間設定為從現在起算 5 分鐘。停用時，工作階段會在指定的工作階段長度後過期，即使最近處於作用中狀態，使用者也會重新導向至登入頁面。	FALSE	Boolean	N/A
storage-cache-max-memory-size	在碎片開始拒絕寫入之前，可以達到的最大大小（以位元組為單位）。	1，073，741，824	Long	下限：0 上限：549，755，813，888	必須低於執行個體的總記憶體容量。我們建議將其設定為低於記憶體總容量的 15%。
storage-cache-snapshot-memory-size	儲存引擎將快照快取並將其寫入 TSM 檔案以提供更多記憶體的大小（以位元組為單位）。	26，214，400	Long	下限：0 上限：549，755，813，888	必須低於 storage-cache-max-memory-size。
storage-cache-snapshot-write-cold-duration	如果碎片未收到寫入或刪除，儲存引擎將快照快取並將其寫入新 TSM 檔案的持續時間。	10 公尺0 秒	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	小時： -下限：0 -上限：256，205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
storage-compact-full-write-cold-duration	如果尚未收到寫入或刪除，儲存引擎將壓縮碎片中所有 TSM 檔案的持續時間。	4h0m0s	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	小時： -下限：0 -上限：256，205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
storage-compact-throughput-burst	TSM 壓縮可寫入磁碟的速率限制（以每秒位元組為單位）。	50，331，648	Long	下限：0 上限：9，223，372，036，854，775，807
storage-max-concurrent-compactions	可同時執行的完整和關卡壓縮數量上限。的值`0`會產生 50% 的執行時間`runtime.GOMAXPROCS(0)`使用。任何大於零的數字都會將壓縮限制為該值。此設定不適用於快取快照。	0	Integer	下限：0 上限：64
storage-max-index-log-file-size	索引預先寫入日誌 (WAL) 檔案將壓縮為索引檔案的大小（以位元組為單位）。較小的大小會導致日誌檔案更快壓縮，並降低堆積使用量，而犧牲寫入輸送量。	1，048，576	Long	下限：0 上限：9，223，372，036，854，775，807
storage-no-validate-field-size	略過傳入寫入請求的欄位大小驗證。	FALSE	Boolean	N/A
storage-retention-check-interval	保留政策強制執行檢查的間隔。	30 公尺0 秒	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	N/A	小時： -下限：0 -上限：256，205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
storage-series-file-max-concurrent-snapshot-compactions	可在資料庫中所有序列分割區同時執行的快照壓縮數目上限。	0	Integer	下限：0 上限：64
storage-series-id-set-cache-size	用於 TSI 索引的內部快取大小，用於存放先前計算的序列結果。執行具有相同標籤索引鍵/值述詞的後續查詢時，會快速傳回快取結果，而不需要重新計算。將此值設為 `0` 將停用快取，並可能會降低查詢效能。	100	Long	下限：0 上限：9，223，372，036，854，775，807
storage-wal-max-concurrent-writes	寫入 WAL 目錄以同時嘗試的最大數量。	0	Integer	下限：0 上限：256
storage-wal-max-write-delay	寫入 WAL 目錄的寫入請求在達到 WAL 目錄的並行作用中寫入數目上限時等待的時間上限。設定為 `0` 以停用逾時。	10m	單位 `hours`、`minutes`、`seconds`、的持續時間`milliseconds`。範例：`durationType=minutes,value=10`	小時： -下限：0 -上限：256205 分鐘： -下限：0 -上限：15，372，286 秒數： -下限：0 -上限：922，337，203 毫秒： -下限：0 -上限：922，337，203，685
ui 停用	停用 InfluxDB 使用者介面 (UI)。預設會啟用 UI。	FALSE	Boolean	N/A

未正確設定參數群組中的參數，可能產生各種意外影響，包括效能降低和系統不穩定。修改資料庫參數時請務必小心。在將這些參數群組變更套用至生產資料庫執行個體之前，在測試資料庫執行個體上測試參數群組設定變更。

使用資料庫參數群組

資料庫執行個體會使用資料庫參數群組。以下各節介紹資料庫執行個體參數群組的設定和管理。

主題

建立資料庫參數群組
將資料庫參數群組與資料庫執行個體建立關聯
列出資料庫參數群組
檢視資料庫參數群組的參數值

建立資料庫參數群組

使用 AWS Management Console

登入 AWS Management Console 並開啟 Amazon Timestream for InfluxDB 主控台。
在導覽窗格中，選擇 Parameter groups (參數群組)。
選擇 Create parameter group (建立參數群組)。
在參數群組名稱方塊中，輸入新資料庫參數群組的名稱。
在 Description (描述) 方塊中，輸入新資料庫參數群組的描述。
選擇要修改的參數，並套用所需的值。如需支援參數的詳細資訊，請參閱支援的參數和參數值。
選擇 Create parameter group (建立參數群組)。

使用 AWS Command Line Interface

若要使用 CLI AWS 建立資料庫參數群組，請使用下列參數呼叫 create-db-parameter-group命令：


--db-parameter-group-name <value>
--description <value>
--endpoint_url <value>
--region <value>
--parameters (list) (string)

範例

如需每項設定的相關資訊，請參閱資料庫執行個體的設定。此範例使用預設引擎組態。


aws timestream-influxdb create-db-parameter-group 
    --db-parameter-group-name YOUR_PARAM_GROUP_NAME \
    --endpoint-url YOUR_ENDPOINT \
    --region YOUR_REGION \
    --parameters "InfluxDBv2={logLevel=debug,queryConcurrency=10,metricsDisabled=true}" \" \
    --debug

將資料庫參數群組與資料庫執行個體建立關聯

您可以使用自訂設定，建立自己的資料庫參數群組。您可以使用 AWS Management Console AWS Command Line Interface、或 Timestream for InfluxDB API，將資料庫參數群組與資料庫執行個體建立關聯。您可以在建立或修改資料庫執行個體時執行此動作。

如需建立資料庫參數群組的資訊，請參閱建立資料庫參數群組。如需建立資料庫執行個體的相關資訊，請參閱建立資料庫執行個體。如需修改資料庫執行個體的相關資訊，請參閱更新資料庫執行個體。

注意

當您將新的資料庫參數群組與資料庫執行個體建立關聯時，修改後的靜態參數只會在資料庫執行個體重新啟動後套用。目前，僅支援立即套用。InfluxDB 的 Timestream 僅支援靜態參數。

使用 AWS Management Console

登入 AWS Management Console 並開啟 Amazon Timestream for InfluxDB 主控台。
在導覽窗格中，選擇 InfluxDB 資料庫，然後選擇您要修改的資料庫執行個體。
選擇更新。更新資料庫執行個體頁面隨即出現。
變更 DB parameter group (資料庫參數群組) 設定。
選擇 Continue (繼續)，並檢查修改的摘要。
目前僅支援立即套用。此選項在某些情況下可能會導致中斷，因為它會重新啟動您的資料庫執行個體。
在確認頁面上，檢閱您的變更。如果正確，請選擇更新資料庫執行個體以儲存變更並套用變更。或者，選擇 Back (上一步) 以編輯變更，或是選擇 Cancel (取消) 以取消變更。

使用 AWS Command Line Interface

若為 Linux、macOS 或 Unix：


aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID \
--region YOUR_REGION \
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID \
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"

針對 Windows：


aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID ^
--region YOUR_REGION ^
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID ^
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"

列出資料庫參數群組

您可以列出您為 AWS 帳戶建立的資料庫參數群組。

使用 AWS Management Console

登入 AWS Management Console 並開啟 Amazon Timestream for InfluxDB 主控台。
在導覽窗格中，選擇 Parameter groups (參數群組)。
資料庫參數群組隨即會出現在清單中。

使用 AWS Command Line Interface

若要列出 AWS 帳戶的所有資料庫參數群組，請使用 AWS Command Line Interface list-db-parameter-groups命令。


aws timestream-influxdb list-db-parameter-groups --region region

若要傳回 AWS 帳戶的特定資料庫參數群組，請使用 AWS Command Line Interface get-db-parameter-group命令。


aws timestream-influxdb get-db-parameter-group --region region --identifier identifier

檢視資料庫參數群組的參數值

您可以從資料庫參數群組取得所有參數與其值的清單。

使用 AWS Management Console

登入 AWS Management Console 並開啟 Amazon Timestream for InfluxDB 主控台。
在導覽窗格中，選擇 Parameter groups (參數群組)。
資料庫參數群組隨即會出現在清單中。
選擇參數群組的名稱，以查看其參數清單。

使用 AWS Command Line Interface

若要檢視資料庫參數群組的參數值，請使用 AWS Command Line Interface get-db-parameter-group 命令。使用您自己的資訊取代 parameter-group-identifier。


get-db-parameter-group --identifier parameter-group-identifier

使用 API

若要檢視資料庫參數群組的參數值，請使用 Timestream API GetDbParameterGroup命令。使用您自己的資訊取代 parameter-group-identifier。


GetDbParameterGroup parameter-group-identifier

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

設定資料庫執行個體

使用僅供讀取複本叢集