datalab %%sql 模块内注释的推荐语法?

recommended syntax for comments inside datalab %%sql module?

我写了一个相当复杂的 %%sql 模块,由 3 个独立的查询组成(第 3 个查询调用前两个),并且一切正常。我回去添加描述性注释以阐明正在做什么(因为这是 material 教程),现在我的第三个查询将不起作用,因为注释行与后续的非注释行包装在一起行——更准确地说,原始 sql 的部分内容正在合并到前面的注释行中,从而从 sql.

中删除

我应该完全避免在 %%sql 模块中放置注释,还是有适当的语法可以让它工作? (或者 gcp.bigquery.Query() 应该在将 sql 传递给 BigQuery 之前智能地删除注释吗?)

我会避免评论。您可以将查询拆分到多个单元格中,并在中间使用降价单元格。

我们过去支持在第一列中以“#”开头的评论,但现在已被删除。

在 %%sql 模块中进行评论的一种方法是在评论开始前使用“--”。

%%sql --module query
-- Comment line 1
-- Comment line 2
SQL code
-- Comment line 3