Todos os produtos
Search
Central de documentação

PolarDB:Log in to PolarDB for AI

Última atualização: Aug 20, 2026

Este tópico descreve como se conectar a um cluster do PolarDB for AI e os requisitos para instruções SQL de IA.

Conectar-se a um cluster

Ao usar o recurso PolarDB for AI, seja ao conectar-se ao cluster usando o DMS, ao conectar-se ao cluster usando um cliente ou ao conectar-se ao cluster via linha de comando, use obrigatoriamente o PolarDB Cluster Endpoint em vez do PolarDB Primary Endpoint. A página Database Connection exibe dois tipos de endpoints de conexão: Primary Endpoint e Cluster Endpoint. Recomendamos o uso do Cluster Endpoint, configurado no modo Read/Write (automatic read/write splitting). Copie o endereço privado ou público correspondente para estabelecer a conexão. Se precisar de outros métodos, clique em Crie Custom Endpoint.

Observações

Conexão via linha de comando

Para usar um hint na conexão via linha de comando, adicione a opção -c. Exemplo:

mysql -h<your_cluster_endpoint> -P<port> -u<your_username> -p<your_password> -c

Conexão via DMS

Por padrão, o DMS conecta-se pelo Primary Endpoint. Para usar o Cluster Endpoint, siga estas etapas:

  1. Após conectar-se ao cluster pelo DMS, localize o cluster desejado no painel de navegação à esquerda, em Database Instance > Instances Connected. Clique com o botão direito no cluster e selecione Edite.

  2. Na caixa de diálogo exibida, altere o Overview > entry mode para Connection String, insira o Cluster Endpoint e clique em Salve.

Nota

O console SQL original usa o Primary Endpoint para conectar-se ao cluster. Após alterar a Connection String, feche o console SQL atual e abra um novo para executar as instruções SQL.

Especificação de SQL para IA

No PolarDB for AI, as instruções SQL compatíveis com recursos e modelos são denominadas PolarDB extended SQL ou AI SQL.

Ao executar uma instrução AI SQL, adicione o prefixo /*polar4ai*/. A instrução será então registrada no log de auditoria.

Exemplo:

/*polar4ai*/CREATE FEATURE test_graph_1 WITH (feature_class='graph') AS (SELECT ip, user_id FROM small_sample limit 30);