mirror of
https://github.com/open-metadata/OpenMetadata.git
synced 2025-07-23 17:30:35 +00:00
390 lines
16 KiB
Markdown
390 lines
16 KiB
Markdown
# Database Service Entity
|
|
|
|
## databaseservice
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json
|
|
```
|
|
|
|
Database service entity that reference services such as MySQL, BigQuery, Redshift, Postgres or Snowflake
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | Yes | Unknown status | No | Forbidden | Allowed | none | [databaseService.json](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### Database service entity Type
|
|
|
|
`object` \([Database service entity](databaseservice.md)\)
|
|
|
|
## Database service entity Properties
|
|
|
|
| Property | Type | Required | Nullable | Defined by |
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|
| [id](databaseservice.md#id) | `string` | Required | cannot be null | [Basic type](../types/basic.md#basic-definitions-uuid) |
|
|
| [name](databaseservice.md#name) | `string` | Required | cannot be null | [Database service entity](databaseservice.md#databaseservice-Properties-Name) |
|
|
| [serviceType](databaseservice.md#servicetype) | `string` | Required | cannot be null | [Database service entity](databaseservice.md#databaseservice-properties-servicetype) |
|
|
| [description](databaseservice.md#description) | `string` | Optional | cannot be null | [Database service entity](databaseservice.md#databaseservice-properties-description) |
|
|
| [href](databaseservice.md#href) | `string` | Required | cannot be null | [Basic type](../types/basic.md#basic-definitions-href) |
|
|
| [jdbc](databaseservice.md#jdbc) | `object` | Required | cannot be null | [Jdbc Connection type](../types/jdbcconnection.md#jdbcconnection-definitions-jdbcinfo) |
|
|
| [ingestionSchedule](databaseservice.md#ingestionschedule) | `object` | Optional | cannot be null | [Schedule type](../types/schedule.md) |
|
|
|
|
### id
|
|
|
|
Unique id used to identify an entity
|
|
|
|
`id`
|
|
|
|
* is required
|
|
* Type: `string`
|
|
* cannot be null
|
|
* defined in: [Basic type](../types/basic.md#basic-definitions-uuid)
|
|
|
|
#### id Type
|
|
|
|
`string`
|
|
|
|
#### id Constraints
|
|
|
|
**UUID**: the string must be a UUID, according to [RFC 4122](https://tools.ietf.org/html/rfc4122)
|
|
|
|
### name
|
|
|
|
Name that identifies the this entity instance uniquely. Same as id if when name is not unique
|
|
|
|
`name`
|
|
|
|
* is required
|
|
* Type: `string`
|
|
* cannot be null
|
|
* defined in: [Database service entity](databaseservice.md#databaseservice-Properties-Name)
|
|
|
|
#### name Type
|
|
|
|
`string`
|
|
|
|
#### name Constraints
|
|
|
|
**maximum length**: the maximum number of characters for this string is: `64`
|
|
|
|
**minimum length**: the minimum number of characters for this string is: `1`
|
|
|
|
### serviceType
|
|
|
|
Type of database service such as MySQL, BigQuery, Snowflake, Redshift, Postgres...
|
|
|
|
`serviceType`
|
|
|
|
* is required
|
|
* Type: `string`
|
|
* cannot be null
|
|
* defined in: [Database service entity](databaseservice.md#databaseservice-properties-servicetype)
|
|
|
|
#### serviceType Type
|
|
|
|
`string`
|
|
|
|
#### serviceType Constraints
|
|
|
|
**enum**: the value of this property must be equal to one of the following values:
|
|
|
|
| Value | Explanation |
|
|
| :--- | :--- |
|
|
| `"BigQuery"` | |
|
|
| `"MySQL"` | |
|
|
| `"Redshift"` | |
|
|
| `"Snowflake"` | |
|
|
| `"Postgres"` | |
|
|
| `"MSSQL"` | |
|
|
| `"Hive"` | |
|
|
|
|
### description
|
|
|
|
Description of database service instance.
|
|
|
|
`description`
|
|
|
|
* is optional
|
|
* Type: `string`
|
|
* cannot be null
|
|
* defined in: [Database service entity](databaseservice.md#databaseservice-properties-description)
|
|
|
|
#### description Type
|
|
|
|
`string`
|
|
|
|
### href
|
|
|
|
Link to the resource corresponding to this entity
|
|
|
|
> Link to the resource
|
|
|
|
`href`
|
|
|
|
* is required
|
|
* Type: `string`
|
|
* cannot be null
|
|
* defined in: [Basic type](../types/basic.md#basic-definitions-href)
|
|
|
|
#### href Type
|
|
|
|
`string`
|
|
|
|
#### href Constraints
|
|
|
|
**URI**: the string must be a URI, according to [RFC 3986](https://tools.ietf.org/html/rfc3986)
|
|
|
|
### jdbc
|
|
|
|
> Type for capturing JDBC connector information
|
|
|
|
`jdbc`
|
|
|
|
* is required
|
|
* Type: `object` \([Details](../types/jdbcconnection.md#jdbcconnection-definitions-jdbcinfo)\)
|
|
* cannot be null
|
|
* defined in: [Jdbc Connection type](../types/jdbcconnection.md#jdbcconnection-definitions-jdbcinfo)
|
|
|
|
#### jdbc Type
|
|
|
|
`object` \([Details](../types/jdbcconnection.md#jdbcconnection-definitions-jdbcinfo)\)
|
|
|
|
### ingestionSchedule
|
|
|
|
Type used for schedule with start time and repeat frequency
|
|
|
|
`ingestionSchedule`
|
|
|
|
* is optional
|
|
* Type: `object` \([Type used for schedule with start time and repeat frequency](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/schemas/entities/schedule.md)\)
|
|
* cannot be null
|
|
* defined in: [Schedule type](../types/schedule.md)
|
|
|
|
#### ingestionSchedule Type
|
|
|
|
`object` \([Type used for schedule with start time and repeat frequency](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/schemas/entities/schedule.md)\)
|
|
|
|
## Database service entity Definitions
|
|
|
|
### Definitions group databaseServiceType
|
|
|
|
Reference this group by using
|
|
|
|
```javascript
|
|
{"$ref":"https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType"}
|
|
```
|
|
|
|
| Property | Type | Required | Nullable | Defined by |
|
|
| :--- | :--- | :--- | :--- | :--- |
|
|
|
|
|
|
## databaseservice-definitions-databaseservicetype-javaenums-0
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType/javaEnums/0
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### 0 Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-definitions-databaseservicetype-javaenums-1
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType/javaEnums/1
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### 1 Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-definitions-databaseservicetype-javaenums-2
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType/javaEnums/2
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### 2 Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-definitions-databaseservicetype-javaenums-3
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType/javaEnums/3
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### 3 Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-definitions-databaseservicetype-javaenums-4
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType/javaEnums/4
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### 4 Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-definitions-databaseservicetype-javaenums-5
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType/javaEnums/5
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### 5 Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-definitions-databaseservicetype-javaenums-6
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions/databaseServiceType/javaEnums/6
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### 6 Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-definitions-databaseservicetype
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/api/services/createDatabaseService.json#/properties/serviceType
|
|
```
|
|
|
|
Type of database service such as MySQL, BigQuery, Snowflake, Redshift, Postgres...
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [createDatabaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/out/api/services/createDatabaseService.json) |
|
|
|
|
### serviceType Type
|
|
|
|
`string`
|
|
|
|
### serviceType Constraints
|
|
|
|
**enum**: the value of this property must be equal to one of the following values:
|
|
|
|
| Value | Explanation |
|
|
| :--- | :--- |
|
|
| `"BigQuery"` | |
|
|
| `"MySQL"` | |
|
|
| `"Redshift"` | |
|
|
| `"Snowflake"` | |
|
|
| `"Postgres"` | |
|
|
| `"MSSQL"` | |
|
|
| `"Hive"` | |
|
|
|
|
## databaseservice-definitions
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/definitions
|
|
```
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### definitions Type
|
|
|
|
unknown
|
|
|
|
## databaseservice-properties-description
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/properties/description
|
|
```
|
|
|
|
Description of database service instance.
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### description Type
|
|
|
|
`string`
|
|
|
|
## databaseservice-properties-name
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/properties/name
|
|
```
|
|
|
|
Name that identifies the this entity instance uniquely. Same as id if when name is not unique
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### name Type
|
|
|
|
`string`
|
|
|
|
### name Constraints
|
|
|
|
**maximum length**: the maximum number of characters for this string is: `64`
|
|
|
|
**minimum length**: the minimum number of characters for this string is: `1`
|
|
|
|
## databaseservice-properties-servicetype
|
|
|
|
```text
|
|
https://github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json#/properties/serviceType
|
|
```
|
|
|
|
Type of database service such as MySQL, BigQuery, Snowflake, Redshift, Postgres...
|
|
|
|
| Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Access Restrictions | Defined In |
|
|
| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
|
| Can be instantiated | No | Unknown status | Unknown identifiability | Forbidden | Allowed | none | [databaseService.json\*](https://github.com/open-metadata/OpenMetadata/tree/88ab3784a5a9e2cfcf56bbb144522498eb33184c/docs/openmetadata-apis/https:/github.com/open-metadata/OpenMetadata/blob/main/catalog-rest-service/src/main/resources/json/schema/entity/services/databaseService.json) |
|
|
|
|
### serviceType Type
|
|
|
|
`string`
|
|
|
|
### serviceType Constraints
|
|
|
|
**enum**: the value of this property must be equal to one of the following values:
|
|
|
|
| Value | Explanation |
|
|
| :--- | :--- |
|
|
| `"BigQuery"` | |
|
|
| `"MySQL"` | |
|
|
| `"Redshift"` | |
|
|
| `"Snowflake"` | |
|
|
| `"Postgres"` | |
|
|
| `"MSSQL"` | |
|
|
| `"Hive"` | |
|
|
|