docs: reword raw-string note in TsFileDataFrame series names Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
diff --git a/src/UserGuide/develop/DataFrame/TsFileDataFrame.md b/src/UserGuide/develop/DataFrame/TsFileDataFrame.md index 91a32ee..1b90dcd 100644 --- a/src/UserGuide/develop/DataFrame/TsFileDataFrame.md +++ b/src/UserGuide/develop/DataFrame/TsFileDataFrame.md
@@ -128,9 +128,9 @@ (distinct from the literal string `"null"`). `list_timeseries()` returns this escaped form — e.g. tag value `Bei.jing` in table `weather` renders as `weather.Bei\.jing.humidity` (a literal `\` becomes `\\`). Selecting needs the -same escaped form, so reuse the `SeriesPath` from `list_timeseries()` (or read -its `.table` / `.tags` / `.field` parts) rather than hand-building it; if you do -type one, use a raw string so Python keeps the backslash: +same escaped form: reuse the `SeriesPath` from `list_timeseries()` (or read its +`.table` / `.tags` / `.field` parts), or write one as a raw string to keep the +backslash: ```python df[r"weather.Bei\.jing.humidity"] # tag "Bei.jing" (the dot is part of the value)
diff --git a/src/UserGuide/latest/DataFrame/TsFileDataFrame.md b/src/UserGuide/latest/DataFrame/TsFileDataFrame.md index 91a32ee..1b90dcd 100644 --- a/src/UserGuide/latest/DataFrame/TsFileDataFrame.md +++ b/src/UserGuide/latest/DataFrame/TsFileDataFrame.md
@@ -128,9 +128,9 @@ (distinct from the literal string `"null"`). `list_timeseries()` returns this escaped form — e.g. tag value `Bei.jing` in table `weather` renders as `weather.Bei\.jing.humidity` (a literal `\` becomes `\\`). Selecting needs the -same escaped form, so reuse the `SeriesPath` from `list_timeseries()` (or read -its `.table` / `.tags` / `.field` parts) rather than hand-building it; if you do -type one, use a raw string so Python keeps the backslash: +same escaped form: reuse the `SeriesPath` from `list_timeseries()` (or read its +`.table` / `.tags` / `.field` parts), or write one as a raw string to keep the +backslash: ```python df[r"weather.Bei\.jing.humidity"] # tag "Bei.jing" (the dot is part of the value)
diff --git a/src/zh/UserGuide/develop/DataFrame/TsFileDataFrame.md b/src/zh/UserGuide/develop/DataFrame/TsFileDataFrame.md index 816a8cc..9fec27c 100644 --- a/src/zh/UserGuide/develop/DataFrame/TsFileDataFrame.md +++ b/src/zh/UserGuide/develop/DataFrame/TsFileDataFrame.md
@@ -113,7 +113,7 @@ - `weather.Beijing.humidity` — 表 `weather`,标签 `Beijing`,字段 `humidity` - `sensor.s1.pressure` — 表 `sensor`,标签 `s1`,字段 `pressure` -**名称中的转义。** `.` 用作分隔符,因此属于表名/标签/字段名本身的 `.` 会用反斜杠转义;空标签值写作 `\N`(与字面字符串 `"null"` 区分)。`list_timeseries()` 返回的就是这种转义形式——例如表 `weather` 中标签值 `Bei.jing`、字段 `humidity` 渲染为 `weather.Bei\.jing.humidity`(字面 `\` 转义为 `\\`)。选取时也要用这种转义形式,因此请直接复用 `list_timeseries()` 返回的 `SeriesPath`(或读取它的 `.table`/`.tags`/`.field`),不要手拼;若确需手写,请用 raw string 让 Python 保留反斜杠: +**名称中的转义。** `.` 用作分隔符,因此属于表名/标签/字段名本身的 `.` 会用反斜杠转义;空标签值写作 `\N`(与字面字符串 `"null"` 区分)。`list_timeseries()` 返回的就是这种转义形式——例如表 `weather` 中标签值 `Bei.jing`、字段 `humidity` 渲染为 `weather.Bei\.jing.humidity`(字面 `\` 转义为 `\\`)。选取时也要用这种转义形式:可直接复用 `list_timeseries()` 返回的 `SeriesPath`(或读取它的 `.table`/`.tags`/`.field`),或用 raw string 保留反斜杠: ```python df[r"weather.Bei\.jing.humidity"] # 标签 "Bei.jing"(点号是值的一部分)
diff --git a/src/zh/UserGuide/latest/DataFrame/TsFileDataFrame.md b/src/zh/UserGuide/latest/DataFrame/TsFileDataFrame.md index 816a8cc..9fec27c 100644 --- a/src/zh/UserGuide/latest/DataFrame/TsFileDataFrame.md +++ b/src/zh/UserGuide/latest/DataFrame/TsFileDataFrame.md
@@ -113,7 +113,7 @@ - `weather.Beijing.humidity` — 表 `weather`,标签 `Beijing`,字段 `humidity` - `sensor.s1.pressure` — 表 `sensor`,标签 `s1`,字段 `pressure` -**名称中的转义。** `.` 用作分隔符,因此属于表名/标签/字段名本身的 `.` 会用反斜杠转义;空标签值写作 `\N`(与字面字符串 `"null"` 区分)。`list_timeseries()` 返回的就是这种转义形式——例如表 `weather` 中标签值 `Bei.jing`、字段 `humidity` 渲染为 `weather.Bei\.jing.humidity`(字面 `\` 转义为 `\\`)。选取时也要用这种转义形式,因此请直接复用 `list_timeseries()` 返回的 `SeriesPath`(或读取它的 `.table`/`.tags`/`.field`),不要手拼;若确需手写,请用 raw string 让 Python 保留反斜杠: +**名称中的转义。** `.` 用作分隔符,因此属于表名/标签/字段名本身的 `.` 会用反斜杠转义;空标签值写作 `\N`(与字面字符串 `"null"` 区分)。`list_timeseries()` 返回的就是这种转义形式——例如表 `weather` 中标签值 `Bei.jing`、字段 `humidity` 渲染为 `weather.Bei\.jing.humidity`(字面 `\` 转义为 `\\`)。选取时也要用这种转义形式:可直接复用 `list_timeseries()` 返回的 `SeriesPath`(或读取它的 `.table`/`.tags`/`.field`),或用 raw string 保留反斜杠: ```python df[r"weather.Bei\.jing.humidity"] # 标签 "Bei.jing"(点号是值的一部分)