常见问题

如何跨账号访问OSS？

在使用Serverless StarRocks进行数据导入或数据湖操作时，您可能需要访问不同阿里云账户下的OSS资源。默认情况下，Serverless StarRocks已配置为对当前账户下的OSS Bucket提供无密码的自动访问权限。如果您需要访问其他账户下的OSS资源，则需先取消当前的默认设置，并手动配置目标账户的访问密钥，然后提交参数以使配置生效。

1. 禁用现有免密访问：在参数配置页签的以下文件中，删除配置项的值，保持配置项内容为空。

   • core-site.xml

     fs.oss.credentials.provider =

   • jindosdk.cfg

     fs.oss.provider.format =
     fs.oss.provider.endpoint =

2. 添加目标账号的AccessKey：在参数配置页签，单击新增配置项，在以下文件中添加下列配置信息。

   • core-site.xml

     fs.oss.accessKeyId = 目标账号的AccessKey ID
     fs.oss.accessKeySecret = 目标账号的AccessKey Secret

   • jindosdk.cfg

     fs.oss.accessKeyId = 目标账号的AccessKey ID
     fs.oss.accessKeySecret = 目标账号的AccessKey Secret

3. 使配置项生效：在参数配置页签，单击提交参数。

如何使用UDF和JDBC连接器驱动？

在使用UDF和JDBC驱动前，您需要从外部获取相应的JAR文件。

1. 上传JAR文件至OSS，详情请参见上传文件。

   在上传文件时，请将文件 ACL设置为公共读写，以确保上传的JAR文件具备公共读写权限。

2. 获取JAR文件的URL。

   对于每个成功上传的JAR文件，在OSS控制台上找到它对应的链接地址。请使用内部网络Endpoint的HTTP URL，格式如下：

   • 对于JDBC驱动：http://<YourBucketName>.oss-cn-xxxx-internal.aliyuncs.com/mysql-connector-java-*.jar。

   • 对于UDF：http://<YourBucketName>.oss-cn-xxxx-internal.aliyuncs.com/<YourPath>/<jar_package_name>。

3. 使用JAR文件，详情请参见Java UDF和JDBC Catalog。

如何重置实例的密码？

1. 进入实例详情页面。

   1. 登录E-MapReduce控制台。

   2. 在左侧导航栏，选择EMR Serverless > StarRocks。

   3. 单击目标实例的名称。

2. 在实例详情页面，单击基础信息区域的重置密码。

3. 在弹出的对话框中，输入新密码和确认密码，单击确定。

为什么向Paimon表写入数据时报错？

• 问题现象：在使用StarRocks向Paimon表写入数据时，可能会遇到以下错误信息。

  (5025, 'Backend node not found. Check if any backend node is down.')

• 问题原因：Paimon表的权限检查机制可能导致StarRocks在进行写入操作时无法正确识别后端节点。

• 解决方法：

  • 升级版本（推荐方式） 如果您使用的版本低于下述版本，请您升级小版本，以更新至最新版本并获得修复。

    • StarRocks 3.2版本：3.2.11-1.89 及以上

    • StarRocks 3.3版本：3.3.8-1.88 及以上

  • 临时解决方法 在StarRocks实例的参数配置页签中的 core-site.xml 配置文件中添加以下配置项。

    dlf.permission.clientCheck=false

在StarRocks中创建外表时提示not a RAM user错误，该如何处理？

• 问题现象：在StarRocks中尝试通过外部表功能创建外表时，可能会遇到以下错误信息。

  current user is not a RAM user

• 问题原因：权限不足或者实例版本较低。

• 解决方法：

  1. 首先检查RAM账号权限：确保使用的RAM账号具有对StarRocks的操作权限，详情请参见为RAM用户授权。

  2. 如果权限无误，请在StarRocks实例的实例详情页面，检查并升级内核版本。

     如果您使用的版本低于以下版本，请您升级小版本，以更新至最新版本并获得修复。

     • StarRocks 3.2版本：3.2.11-1.89 及以上

     • StarRocks 3.3版本：3.3.8-1.88 及以上

为什么在SQL Editor中执行包含分号的SQL时会报错？

• 问题现象：在SQL Editor中执行包含分号（;）的SQL时报错，报错信息包含the most similar input is {a legal identifier} 。

  

• 问题原因：因为SQL Editor默认将分号（;）作为语句结束符。如果您的SQL语句中包含分号（;），则会导致语法解析错误。

• 解决方法：

  1. 设置自定义分隔符。

     在执行包含分号的SQL语句前，设置一个自定义分隔符，以避免语法解析错误。例如，改为$$。

     delimiter $$

  2. 执行包含分号的SQL语句。本文示例如下所示。

     INSERT INTO sr_test VALUES 
     (1, 'asdsd,asdsads'), 
     (2, 'sadsad;asdsads');

  3. 恢复默认分隔符。

     在执行完SQL语句后，恢复默认的分隔符（;），以便后续的SQL操作可以正常使用。

     delimiter ;

  4. 验证结果。

     执行查询语句验证数据是否正确插入。

     

为什么Serverless StarRocks在导入数据或访问外表时失败？

• 问题现象：在使用Serverless StarRocks进行数据导入或访问外部表时，如果目标地址为公网地址，可能会遇到导入失败或连接失败的问题。

• 原因分析：Serverless StarRocks实例默认运行在专有网络（VPC）环境中，该环境可能不具备直接访问公网的能力。因此，当需要访问公网资源（如导入数据或查询外部表）时，若未配置公网访问能力，请求将无法成功。

• 解决方法：您可以通过在VPC中部署公网NAT网关并启用SNAT功能，使Serverless StarRocks实例能够通过该网关访问公网资源。更多信息，请参见使用公网NAT网关SNAT功能访问互联网。

如何避免StarRocks实例中的CLB/SLB因连接空闲超时而关闭客户端连接？

• 问题现象：在StarRocks实例中，当FE节点数大于1时，可以通过开通SLB（Server Load Balancer）实现负载均衡，详情请参见管理网关。当StarRocks实例开启SLB后，若SQL查询执行时间超过900秒，客户端与SLB之间的连接会被强制断开，导致查询结果无法返回。

• 问题原因：SLB的TCP连接存在一个最大空闲超时时间（900 秒）。如果客户端与SLB之间的连接在900秒内没有数据传输（例如，执行长时间运行的SQL查询），SLB会主动关闭该连接。这会导致客户端在等待StarRocks响应时出现连接中断的问题。

• 解决方法：通过设置客户端的TCP Keepalive参数以维持客户端和SLB之间的连接，避免连接空闲超时关闭。

  • 全局内核参数设置（系统级）

    通过修改操作系统的内核参数，为所有TCP连接启用并配置合理的TCP Keepalive参数，以检测网络连接的存活状态。以下是需要设置的参数及其具体含义。

    参数	含义	建议值
    Linux系统：net.ipv4.tcp_keepalive_time FreeBSD/macOS：net.inet.tcp.keepidle	连接空闲多久后发送第一个Keepalive探测包（单位：秒）。	600秒
    Linux系统：net.ipv4.tcp_keepalive_intvl FreeBSD/macOS：net.inet.tcp.keepintvl	Keepalive探测包的重传间隔（单位：秒）。	60秒
    Linux系统：net.ipv4.tcp_keepalive_probes FreeBSD/macOS：net.inet.tcp.keepcnt	探测包连续发送失败的次数，达到此值后断开连接。	5次

    Linux系统

    • 临时生效

      # 设置全局Keepalive参数（需要root权限）
      sudo sysctl -w net.ipv4.tcp_keepalive_time=600   # 对应keepidle（600秒）
      sudo sysctl -w net.ipv4.tcp_keepalive_intvl=60   # 对应keepintvl（60秒）
      sudo sysctl -w net.ipv4.tcp_keepalive_probes=5   # 对应keepcount（5次）

    • 永久生效

      将以下内容添加到/etc/sysctl.conf，并执行sysctl -p生效。

      echo "net.ipv4.tcp_keepalive_time = 600" >> /etc/sysctl.conf
      echo "net.ipv4.tcp_keepalive_intvl = 60" >> /etc/sysctl.conf
      echo "net.ipv4.tcp_keepalive_probes = 5" >> /etc/sysctl.conf

    FreeBSD/macOS系统

    • 临时生效

      # 设置全局Keepalive参数（需要root权限）
      sudo sysctl -w net.inet.tcp.keepidle=600
      sudo sysctl -w net.inet.tcp.keepintvl=60
      sudo sysctl -w net.inet.tcp.keepcnt=5

    • 永久生效

      将以下内容添加到/etc/sysctl.conf。

      echo "net.inet.tcp.keepidle = 600" >> /etc/sysctl.conf
      echo "net.inet.tcp.keepintvl = 60" >> /etc/sysctl.conf
      echo "net.inet.tcp.keepcnt = 5" >> /etc/sysctl.conf

  • 编程语言适配（应用级）

    通过语言特定的API设置单个连接的TCP Keepalive参数。

    Java

    Java标准库对TCP Keepalive的支持有限，但可以通过反射或底层Socket选项实现。

    说明

    以下代码依赖于系统（如Linux/FreeBSD）对 tcp_keepidle等选项的支持。此外，部分方法（如反射）可能因JVM版本差异而失效，建议在实际使用前进行兼容性测试。

    import java.io.IOException;
    import java.net.InetSocketAddress;
    import java.net.Socket;
    import java.net.SocketOption;
    import java.nio.channels.SocketChannel;
    
    public class TcpKeepaliveExample {
    
        public static void main(String[ ] args) {
    
            try (Socket socket = new Socket()) {
                // 1. 启用 Keepalive
                socket.setKeepAlive(true);
    
                // 2. 设置 Keepalive 参数（需通过底层 Socket 选项）
                SocketChannel channel = socket.getChannel();
                if (channel != null) {
                    // 设置 Keepidle（空闲时间）
                    channel.setOption(StandardSocketOptions.SO_KEEPALIVE, true); // 必须先启用 Keepalive
                    setSocketOptionInt(socket, "tcp_keepidle", 600); // 需要系统支持
    
                    // 设置 Keepintvl（重传间隔）
                    setSocketOptionInt(socket, "tcp_keepintvl", 60);
    
                    // 设置 Keepcount（失败次数）
                    setSocketOptionInt(socket, "tcp_keepcnt", 5); // 注意：参数名可能因系统而异
                }
    
                // 连接到服务器
                socket.connect(new InetSocketAddress("example.com", 80));
                // ... 其他操作 ...
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    
        // 通过反射设置系统特定的 Socket 选项（如 Linux/FreeBSD）
        private static void setSocketOptionInt(Socket socket, String optionName, int value) {
            try {
                Class<?> clazz = Class.forName("java.net.Socket$SocketOptions");
                Object options = clazz.getDeclaredMethod("options").invoke(socket);
                Class<?> optionsClass = options.getClass();
                optionsClass.getDeclaredMethod("setOption", String.class, int.class)
                        .invoke(options, optionName, value);
            } catch (Exception e) {
                throw new RuntimeException("Failed to set socket option " + optionName, e);
            }
        }
    }

    Python

    Python的socket模块支持直接配置TCP Keepalive参数。

    说明

    不同操作系统可能使用不同的参数名称（例如，macOS可能需用TCP_KEEPALIVE代替TCP_KEEPIDLE），且部分参数可能需要root权限才能进行设置。

    import socket
    
    def create_keepalive_socket():
        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        
        # 1. 启用 Keepalive
        sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
        
        # 2. 设置 Keepalive 参数（Linux/FreeBSD）
        # Keepidle: 600秒
        sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPIDLE, 600)
        
        # Keepintvl: 60秒
        sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPINTVL, 60)
        
        # Keepcount: 5次
        sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPCNT, 5)
        
        return sock
    
    # 使用示例
    sock = create_keepalive_socket()
    sock.connect(("example.com", 80))
    # ... 其他操作 ...
    sock.close()

    Golang

    Golang的net包提供了基础的Keepalive配置，但需通过底层的syscall包设置详细参数。

    说明

    不同操作系统可能使用不同的参数名称，且部分参数可能需要root权限才能进行设置。

    package main
    
    import (
        "fmt"
        "net"
        "syscall"
    )
    
    func main() {
        // 创建 TCP 连接
        conn, err := net.Dial("tcp", "example.com:80")
        if err != nil {
            panic(err)
        }
        defer conn.Close()
    
        // 获取底层文件描述符
        fd := conn.(*net.TCPConn).SyscallConn()
    
        // 设置 Keepalive 参数
        fd.Control(func(fdPtr *net.FileDesc) {
            fd := fdPtr.File
            // 启用 Keepalive
            err = syscall.SetsockoptInt(int(fd), syscall.IPPROTO_TCP, syscall.TCP_KEEPALIVE, 1)
            if err != nil {
                panic(err)
            }
    
            // 设置 Keepidle（空闲时间）
            err = syscall.SetsockoptInt(int(fd), syscall.SOL_TCP, syscall.TCP_KEEPIDLE, 600)
            if err != nil {
                panic(err)
            }
    
            // 设置 Keepintvl（重传间隔）
            err = syscall.SetsockoptInt(int(fd), syscall.SOL_TCP, syscall.TCP_KEEPINTVL, 60)
            if err != nil {
                panic(err)
            }
    
            // 设置 Keepcount（失败次数）
            err = syscall.SetsockoptInt(int(fd), syscall.SOL_TCP, syscall.TCP_KEEPCNT, 5)
            if err != nil {
                panic(err)
            }
        })
    
        // ... 其他操作 ...
    }

StarRocks备份数据报错Unexpected exception: Table '' is not a OLAP table

• 问题现象：在使用StarRocks进行数据快照备份时，遇到以下报错信息。

  Unexpected exception: Table '<table_name>' is not a OLAP table

• 原因分析：

  • 实例为存算分离模式

    StarRocks存算分离实例不支持数据备份和恢复功能，仅存算一体实例支持此功能。

  • 表引擎类型不兼容

    StarRocks的备份功能仅支持OLAP引擎的表。如果表的引擎类型不是OLAP，则会触发该报错。

• 解决方法：

  • 查看实例类型。

    在StarRocks的实例列表中，查看实例类型。如果实例为存算分离版，则不支持数据备份和恢复功能。建议您使用存算一体实例以启用备份和恢复功能。更多信息，请参见备份与恢复（Beta）。

  • 检查表引擎类型。

    检查目标表的DDL定义，确认是否设置了ENGINE=OLAP。

    SHOW CREATE TABLE <table_name>;

    如果表的引擎不是OLAP，请根据业务需求重新创建表，并确保指定ENGINE=OLAP。