Managed Service for Trino API, REST: Catalog.Get

Статья создана

Обновлена 3 октября 2025 г.

HTTP request
Path parameters
Response
Connector
HiveConnector
Metastore
HiveMetastore
FileSystem
ExternalS3FileSystem
IcebergConnector
DeltaLakeConnector
PostgresqlConnector
PostgresqlConnection
OnPremise
ConnectionManager
ClickhouseConnector
ClickhouseConnection
OnPremise
ConnectionManager
TPCHConnector
TPCDSConnector
OracleConnector
OracleConnection
OnPremise
SQLServerConnector
SQLServerConnection
OnPremise
HudiConnector

Returns the specified Trino Catalog resource.

HTTP request

GET https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/{clusterId}/catalogs/{catalogId}

Path parameters

Field

Description

clusterId

string

Required field. ID of the Trino Cluster resource which contains the requested catalog.

catalogId

string

Required field. ID of the Trino Catalog resource.

Response

HTTP Code: 200 - OK

{
  "id": "string",
  "name": "string",
  "connector": {
    // Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`
    "hive": {
      "metastore": {
        // Includes only one of the fields `hive`
        "hive": {
          // Includes only one of the fields `uri`
          "uri": "string"
          // end of the list of possible fields
        }
        // end of the list of possible fields
      },
      "filesystem": {
        // Includes only one of the fields `s3`, `externalS3`
        "s3": "object",
        "externalS3": {
          "awsAccessKey": "string",
          "awsSecretKey": "string",
          "awsEndpoint": "string",
          "awsRegion": "string"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    },
    "iceberg": {
      "metastore": {
        // Includes only one of the fields `hive`
        "hive": {
          // Includes only one of the fields `uri`
          "uri": "string"
          // end of the list of possible fields
        }
        // end of the list of possible fields
      },
      "filesystem": {
        // Includes only one of the fields `s3`, `externalS3`
        "s3": "object",
        "externalS3": {
          "awsAccessKey": "string",
          "awsSecretKey": "string",
          "awsEndpoint": "string",
          "awsRegion": "string"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    },
    "deltaLake": {
      "metastore": {
        // Includes only one of the fields `hive`
        "hive": {
          // Includes only one of the fields `uri`
          "uri": "string"
          // end of the list of possible fields
        }
        // end of the list of possible fields
      },
      "filesystem": {
        // Includes only one of the fields `s3`, `externalS3`
        "s3": "object",
        "externalS3": {
          "awsAccessKey": "string",
          "awsSecretKey": "string",
          "awsEndpoint": "string",
          "awsRegion": "string"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    },
    "postgresql": {
      "connection": {
        // Includes only one of the fields `onPremise`, `connectionManager`
        "onPremise": {
          "connectionUrl": "string",
          "userName": "string",
          "password": "string"
        },
        "connectionManager": {
          "connectionId": "string",
          "database": "string",
          "connectionProperties": "object"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    },
    "clickhouse": {
      "connection": {
        // Includes only one of the fields `onPremise`, `connectionManager`
        "onPremise": {
          "connectionUrl": "string",
          "userName": "string",
          "password": "string"
        },
        "connectionManager": {
          "connectionId": "string",
          "database": "string",
          "connectionProperties": "object"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    },
    "tpch": {
      "additionalProperties": "object"
    },
    "tpcds": {
      "additionalProperties": "object"
    },
    "oracle": {
      "connection": {
        // Includes only one of the fields `onPremise`
        "onPremise": {
          "connectionUrl": "string",
          "userName": "string",
          "password": "string"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    },
    "sqlserver": {
      "connection": {
        // Includes only one of the fields `onPremise`
        "onPremise": {
          "connectionUrl": "string",
          "userName": "string",
          "password": "string"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    },
    "hudi": {
      "metastore": {
        // Includes only one of the fields `hive`
        "hive": {
          // Includes only one of the fields `uri`
          "uri": "string"
          // end of the list of possible fields
        }
        // end of the list of possible fields
      },
      "filesystem": {
        // Includes only one of the fields `s3`, `externalS3`
        "s3": "object",
        "externalS3": {
          "awsAccessKey": "string",
          "awsSecretKey": "string",
          "awsEndpoint": "string",
          "awsRegion": "string"
        }
        // end of the list of possible fields
      },
      "additionalProperties": "object"
    }
    // end of the list of possible fields
  },
  "description": "string",
  "labels": "object"
}

Catalog is a logical Trino catalog backed by a specific connector.

Field	Description
id	string ID of the catalog.
name	string Name of the catalog.
connector	Connector Connector backing this catalog.
description	string Description of the catalog.
labels	object (map<string, string>) Labels associated with the catalog.

Connector

Connector configuration. Exactly one connector type must be specified.

Field	Description
hive	HiveConnector Hive connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
iceberg	IcebergConnector Iceberg connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
deltaLake	DeltaLakeConnector Delta Lake connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
postgresql	PostgresqlConnector PostgreSQL connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
clickhouse	ClickhouseConnector ClickHouse connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
tpch	TPCHConnector TPC-H connector for synthetic benchmarking. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
tpcds	TPCDSConnector TPC-DS connector for synthetic benchmarking. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
oracle	OracleConnector Oracle connector configuration for connecting to Oracle Database instances. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
sqlserver	SQLServerConnector SQLServer connector configuration for connecting to SQLServer Database instances. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.
hudi	HudiConnector Hudi connector configuration. Includes only one of the fields `hive`, `iceberg`, `deltaLake`, `postgresql`, `clickhouse`, `tpch`, `tpcds`, `oracle`, `sqlserver`, `hudi`.

HiveConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

Metastore

Metastore configuration.

Field

Description

hive

HiveMetastore

Includes only one of the fields hive.

HiveMetastore

Configuration of Hive's metastore type.

Field

Description

uri

string

URI or cluster ID of the Hive Metastore.

Includes only one of the fields uri.

FileSystem

Configuration of file system used by a connector.

Field

Description

object

Includes only one of the fields s3, externalS3.

externalS3

ExternalS3FileSystem

Includes only one of the fields s3, externalS3.

ExternalS3FileSystem

Describes External S3 compatible file system.

Field	Description
awsAccessKey	string Required field.
awsSecretKey	string Required field.
awsEndpoint	string Required field.
awsRegion	string Required field.

IcebergConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

DeltaLakeConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

PostgresqlConnector

Field

Description

connection

PostgresqlConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

PostgresqlConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise, connectionManager.

connectionManager

ConnectionManager

Includes only one of the fields onPremise, connectionManager.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the Postgresql.
userName	string Required field. Name of the Postgresql user.
password	string Required field. Password of the Postgresql user.

ConnectionManager

Field	Description
connectionId	string Required field. Connection ID.
database	string Required field. Database.
connectionProperties	object (map<string, string>) Additional connection properties.

ClickhouseConnector

Field

Description

connection

ClickhouseConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

ClickhouseConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise, connectionManager.

connectionManager

ConnectionManager

Includes only one of the fields onPremise, connectionManager.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the Clickhouse.
userName	string Required field. Name of the Clickhouse user.
password	string Required field. Password of the Clickhouse user.

ConnectionManager

Field	Description
connectionId	string Required field. Connection ID.
database	string Required field. Database.
connectionProperties	object (map<string, string>) Additional connection properties.

TPCHConnector

Field

Description

additionalProperties

object (map<string, string>)

Additional properties.

TPCDSConnector

Field

Description

additionalProperties

object (map<string, string>)

Additional properties.

OracleConnector

Field

Description

connection

OracleConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

OracleConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the Oracle.
userName	string Required field. Name of the Oracle user.
password	string Required field. Password of the Oracle user.

SQLServerConnector

Field

Description

connection

SQLServerConnection

Connection configuration.

additionalProperties

object (map<string, string>)

Additional properties.

SQLServerConnection

Field

Description

onPremise

OnPremise

Includes only one of the fields onPremise.

OnPremise

Field	Description
connectionUrl	string Required field. Connection to the SQLServer.
userName	string Required field. Name of the SQLServer user.
password	string Required field. Password of the SQLServer user.

HudiConnector

Field	Description
metastore	Metastore Required field. Metastore configuration.
filesystem	FileSystem Required field. File system configuration.
additionalProperties	object (map<string, string>) Additional properties.

Managed Service for Trino API, REST: Catalog.Get

HTTP requestHTTP request

Path parametersPath parameters

ResponseResponse

ConnectorConnector

HiveConnectorHiveConnector

MetastoreMetastore

HiveMetastoreHiveMetastore

FileSystemFileSystem

ExternalS3FileSystemExternalS3FileSystem

IcebergConnectorIcebergConnector

DeltaLakeConnectorDeltaLakeConnector

PostgresqlConnectorPostgresqlConnector

PostgresqlConnectionPostgresqlConnection

OnPremiseOnPremise

ConnectionManagerConnectionManager

ClickhouseConnectorClickhouseConnector

ClickhouseConnectionClickhouseConnection

OnPremiseOnPremise

ConnectionManagerConnectionManager

TPCHConnectorTPCHConnector

TPCDSConnectorTPCDSConnector

OracleConnectorOracleConnector

OracleConnectionOracleConnection

OnPremiseOnPremise

SQLServerConnectorSQLServerConnector

SQLServerConnectionSQLServerConnection

OnPremiseOnPremise

HudiConnectorHudiConnector

Была ли статья полезна?

HTTP request

Path parameters

Response

Connector

HiveConnector

Metastore

HiveMetastore

FileSystem

ExternalS3FileSystem

IcebergConnector

DeltaLakeConnector

PostgresqlConnector

PostgresqlConnection

OnPremise

ConnectionManager

ClickhouseConnector

ClickhouseConnection

OnPremise

ConnectionManager

TPCHConnector

TPCDSConnector

OracleConnector

OracleConnection

OnPremise

SQLServerConnector

SQLServerConnection

OnPremise

HudiConnector