新建SQL查询

操作步骤

1. 在Dataphin首页，在顶部菜单栏选择分析 > SQL查询。

2. 在SQL查询列表中，单击新建图标。

3. 在新建SQL查询对话框，配置以下参数。

   参数	说明
   SQL查询名称	允许最长字符256个，不支持竖线（｜）、正斜线（/）、反斜线（\）、半角冒号（:）、半角问号（?）、尖括号（<>）、星号（*）和半角引号（"）。
   目录位置	选择任务所存放的目录。 若未创建目录，可单击SQL查询列表上的图标来新建文件夹。新建文件夹对话框中，输入文件夹名称并选择目录所在位置后，单击确定。
   查询数据	支持项目数据和数据源。 项目数据：即查询当前项目计算源的数据。 数据源：即查询数据源的数据，支持的数据源类型请参见分析平台支持的数据源。查询数据源数据还需要进行以下配置： 数据源：选择对应数据源（包括外部数据源）。若无可选数据源，可以单击+新建数据源进行新建。更多信息，请参见数据源管理。 Catalog：Presto、Trino数据源需要选择对应的Catalog。 Database/Schema：MySQL、PostgreSQL、Hologres、AnalyticDB for PostgreSQL、OceanBase（Oracle租户模式）、Lindorm、Oracle、ClickHouse、DM、openGauss、StarRocks、Doris、SelectDB、Presto、GaussDB（DWS）、Trino、PolarDB-X2.0、OushuDB数据源需要选择对应的Database/Schema。

4. 单击确定，完成SQL查询新建。默认打开该SQL查询的代码编辑页签。

   在代码编辑页签下，可以进行数据库SQL开发。

5. （可选）您可配置并开启查询加速，开启后需选择加速方式。

   • 加速源：通过加速源进行查询加速，加速方式选择为加速源时，还需要选择加速源和资源组。

     • 加速源：可选择当前项目计算源所绑定的加速源，若无可用加速源，可单击新建加速源，跳转至新建加速源页面按需创建加速源。

     • 资源组（非必选）：可选择所选加速源下已配置的资源组。

     说明

     加速方式选择加速源，运行时将按照所选加速源类型的语法来运行，需确保SQL语句符合语法规范。例如，所选加速源类型为StarRocks，则运行此SQL查询任务时，将按照StarRocks语法来运行。

   • MCQA：即MaxCompute MCQA加速查询。MCQA每一个租户下，作业数量与并发数有限制，可能会导致加速失败、执行报错，详情请参见查询加速（MCQA）。您可在管理中心 > 系统设置 > 研发平台 > 查询加速中禁用MCQA加速。

   不同计算引擎的不同情况下，支持的加速方式不同。

   当前租户使用MaxCompute计算引擎时：

   • 若未购买查询加速，且已开启研发平台-查询加速时，此处加速方式为MCQA。

   • 若已购买查询加速、已开启研发平台-查询加速、且当前项目对应的计算源未绑定加速源时，此处加速方式为MCQA。

   • 若已购买查询加速，且项目对应的计算源已绑定加速源，此处加速方式可选择加速源或MCQA。

   当前租户使用Hadoop计算引擎时：已购买查询加速，且项目计算源对应的集群已绑定加速源，此处加速方式为加速源。

6. 数据库SQL代码编辑完成后，可单击运行，系统将解析代码中所有对象确认当前用户是否具备对象的操作权限。若权限校验成功，说明当前操作用户具备检查对象的相应权限；若权限校验失败，则表明当前操作用户不具备对应对象的权限，并在权限校验失败对话框中展示相应的无权限对象列表。

   说明

   数据库SQL查询任务运行时默认使用所选数据源中配置的默认资源组，而非分析项目的默认资源组。

   权限校验失败对话框中将展示对象名称、对象类型、权限类型和操作信息。

   • 对象名称：无权限对象的对象名称。

   • 对象类型：表和全局变量。

   • 权限类型：本次运行脚本中所需要的权限，其中数据源表只有查表数据权限；数据源只有执行权限。

   • 操作：若检查对象失败，您可以针对单个或多个对象进行权限申请。

     • 单个对象权限申请：单击目标对象操作列的图标，申请该对象权限点的个人权限，默认有效期为30天。

     • 批量权限申请：选中多个对象或选中全选表后单击权限申请。

     申请权限具体操作，请参见申请权限。获得权限后可重新运行。

     说明

     仅MySQL、Oracle类型的数据源，支持数据源的表级权限管控。

单租户多引擎

在多引擎模式下新建SQL查询时，查询数据若选择为项目数据，则还需选择执行项目，执行项目中需选择集群和项目。其他参数同单引擎模式，详情请参见上文。

• 集群：可选项中包含当前租户下所有集群以及无集群项目。SQL查询创建完成后，不支持切换集群。

• 项目：可选项中包含所选集群下的项目和集群的分析专用项目。集群分析专用项名称固定为{集群名称}分析项目；无集群项目分析专用项目名称为无集群独立分析项目。

执行项目选择完成后，系统将根据所选集群创建对应的引擎类型SQL，二者对应关系如下。