<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"><channel><title>Cloudflare changelogs | Analytics</title><description>Cloudflare changelogs for Analytics</description><link>https://cloudflaredoc.ubitools.com/changelog/</link><item><title>Analytics - SQL API 自省：`include_attributes` 参数</title><link>https://cloudflaredoc.ubitools.com/changelog/post/2026-10-27-introspection-include-attributes/</link><guid isPermaLink="true">https://cloudflaredoc.ubitools.com/changelog/post/2026-10-27-introspection-include-attributes/</guid><description>&lt;p&gt;SQL API 自省端点新增了 &lt;code&gt;include_attributes&lt;/code&gt; 查询参数。将其设置为 &lt;code&gt;true&lt;/code&gt; 后，系统会根据您账户前七天的数据，发现数据集 &lt;code&gt;attributes&lt;/code&gt; JSON 列中的键及其类型。发现的键将在数据集的 &lt;code&gt;attributes&lt;/code&gt; 响应字段中返回。&lt;/p&gt;
&lt;p&gt;部分数据集会将额外的键值数据存储在 &lt;code&gt;attributes&lt;/code&gt; JSON 列中，您可以使用精确键查找（例如 &lt;code&gt;attributes[&apos;http.method&apos;]&lt;/code&gt;）进行查询。此前用于发现这些键的方式 &lt;code&gt;include_custom_attributes&lt;/code&gt; 会在 &lt;code&gt;custom_attributes&lt;/code&gt; 字段中返回名称。新的命名更清楚地表明，返回的每个名称都是您通过 &lt;code&gt;attributes&lt;/code&gt; 列访问的键。&lt;/p&gt;
&lt;p&gt;&lt;code&gt;include_custom_attributes&lt;/code&gt; 和 &lt;code&gt;custom_attributes&lt;/code&gt; 已弃用，但仍可使用。请更新集成以改用 &lt;code&gt;include_attributes&lt;/code&gt; 和 &lt;code&gt;attributes&lt;/code&gt;。&lt;/p&gt;
&lt;figure class=&quot;nb-code-figure&quot; data-nb-lang=&quot;bash&quot;&gt;&lt;pre class=&quot;astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz&quot; tabindex=&quot;0&quot; data-language=&quot;bash&quot; data-nb-lang=&quot;bash&quot;&gt;&lt;code&gt;&lt;span class=&quot;line&quot;&gt;&lt;span class=&quot;nb-shiki-1t8gfj&quot;&gt;curl&lt;/span&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt; --get&lt;/span&gt;&lt;span class=&quot;nb-shiki-mdbnqw&quot;&gt; &quot;https://api.cloudflare.com/client/v4/analytics/sql/introspection&quot;&lt;/span&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt;  --header&lt;/span&gt;&lt;span class=&quot;nb-shiki-mdbnqw&quot;&gt; &quot;Authorization: Bearer &amp;lt;API_TOKEN&amp;gt;&quot;&lt;/span&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt;  --data-urlencode&lt;/span&gt;&lt;span class=&quot;nb-shiki-mdbnqw&quot;&gt; &quot;account_tag=&amp;lt;ACCOUNT_TAG&amp;gt;&quot;&lt;/span&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt;  --data-urlencode&lt;/span&gt;&lt;span class=&quot;nb-shiki-mdbnqw&quot;&gt; &quot;dataset_name=events.httpRequests&quot;&lt;/span&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;line&quot;&gt;&lt;span class=&quot;nb-shiki-dzsirb&quot;&gt;  --data-urlencode&lt;/span&gt;&lt;span class=&quot;nb-shiki-mdbnqw&quot;&gt; &quot;include_attributes=true&quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;
&lt;p&gt;有关详细信息，请参阅 &lt;a href=&quot;https://cloudflaredoc.ubitools.com/analytics/sql-api/datasets/#attributes&quot;&gt;Attributes&lt;/a&gt;。&lt;/p&gt;</description><pubDate>Tue, 27 Oct 2026 00:00:00 GMT</pubDate><product>Analytics</product><category>Analytics</category></item></channel></rss>