Como Trabalhar com a API Python Data Studio para Autonomous Database

O pacote de API do Python Data Studio funciona no notebook OML e como um aplicativo independente.

Você pode exibir os pontos finais da API REST hospedados no Oracle Autonomous Database. Esses pontos finais permitem que você armazene modelos de Machine Learning com seus metadados e crie pontos finais de pontuação para o modelo.

Instalando a API do Python Data Studio

Instale o pacote base do PyPI:

pip install oracle-data-studio

A instalação base inclui os clientes Autonomous Database (adp), Essbase (essbase) e Data Transforms (datatatransforms). Os recursos opcionais são instalados como extras:

pip install "oracle-data-studio[mcp]"               # MCP server
pip install "oracle-data-studio[agents]"            # A2A agent runtime
pip install "oracle-data-studio[agents,openai]"     # agents + OpenAI model adapter
pip install "oracle-data-studio[agents,anthropic]"  # agents + Anthropic model adapter
pip install "oracle-data-studio[oracle]"            # Oracle-DB-backed durable agent store
pip install "oracle-data-studio[redis]"             # Redis-backed durable agent store

Estabelecendo Conexão com o Autonomous Database

Para estabelecer conexão com o Autonomous Database por meio do seu nome de usuário e senha, execute o seguinte comando:

import adp 
adp_instance = adp.login('<url>', '<username>', '<password>')

Aqui estão os parâmetros e suas descrições:

url: Especifica o host do Database Actions. Por exemplo, https://abcdefg.oraclecloudapps.com.

username: Especifica o nome do esquema.

password: Especifica a senha do esquema.

Estabelecendo Conexão com Notebooks OML

Faça log-in nos notebooks OML informando o seguinte comando:

import adp
adp_instance = adp.connect()

O valor de retorno do método de log-in é uma instância de classe que contém todas as funções do Autonomous Data Platform (ADP).

A instância da classe Adp consiste nas seguintes classes internas:

• Ingestão
• Analytics
• Insight
• Diversos
• Compartilhamento de Dados

Consulte as seguintes funções no capítulo subsequente.

Tópicos:

• Ingestão de Funções
  A classe Adp.Ingest é usada para carregar dados de diferentes origens em tabelas e views.
• Funções de View Analítica
  A classe Adp.Analytics fornece a sintaxe e as descrições das classes, métodos, atributos e parâmetros da interface de programação do aplicativo para a ferramenta Views Analíticas do Conjunto de ferramentas do Data Studio. Se a view analítica solicitada não existir (exceto criar), todas as funções retornarão a mensagem Analytic view does not exist.
• Funções do Insight
  As funções do Insight fornecem a sintaxe e as descrições das classes, métodos, atributos e parâmetros da interface de programação do aplicativo para a ferramenta Insight no conjunto de ferramentas do Data Studio. A geração de insights é realizada em segundo plano e requer a verificação da conclusão.
• Funções diversas
  As funções diversas fornecem a sintaxe e as descrições das classes, dos métodos, dos atributos e dos parâmetros da interface de programação do aplicativo.
• Funções de Compartilhamento de Dados
  A API (Application Programming Interface) do Python Data Studio para funções de Compartilhamento de Dados fornece a sintaxe e as descrições das classes, métodos, atributos e parâmetros da interface de programação de aplicativos para a ferramenta de Compartilhamento de Dados do conjunto de ferramentas do Data Studio.
• Funções de Catálogo
  O Catálogo ou o Catálogo do Oracle Data Studio é uma ferramenta de vários catálogos que fornece uma maneira de procurar dados e outros objetos no seu Autonomous Database conectado no momento e também em uma ampla variedade de outros sistemas conectados.