Google Cloud Dataplex V1 Client - Class Entity (0.5.1)

Reference documentation and code samples for the Google Cloud Dataplex V1 Client class Entity.

Represents tables and fileset metadata contained within a zone.

Generated from protobuf message google.cloud.dataplex.v1.Entity

Namespace

Google \ Cloud \ Dataplex \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ name string

Output only. The resource name of the entity, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{id}.

↳ display_name string

Optional. Display name must be shorter than or equal to 256 characters.

↳ description string

Optional. User friendly longer description text. Must be shorter than or equal to 1024 characters.

↳ create_time Google\Protobuf\Timestamp

Output only. The time when the entity was created.

↳ update_time Google\Protobuf\Timestamp

Output only. The time when the entity was last updated.

↳ id string

Required. A user-provided entity ID. It is mutable, and will be used as the published table name. Specifying a new ID in an update entity request will override the existing value. The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores, and consist of 256 or fewer characters.

↳ etag string

Optional. The etag associated with the entity, which can be retrieved with a GetEntity request. Required for update and delete requests.

↳ type int

Required. Immutable. The type of entity.

↳ asset string

Required. Immutable. The ID of the asset associated with the storage location containing the entity data. The entity must be with in the same zone with the asset.

↳ data_path string

Required. Immutable. The storage path of the entity data. For Cloud Storage data, this is the fully-qualified path to the entity, such as gs://bucket/path/to/data. For BigQuery data, this is the name of the table resource, such as projects/project_id/datasets/dataset_id/tables/table_id.

↳ data_path_pattern string

Optional. The set of items within the data path constituting the data in the entity, represented as a glob path. Example: gs://bucket/path/to/data/**/*.csv.

↳ catalog_entry string

Output only. The name of the associated Data Catalog entry.

↳ system int

Required. Immutable. Identifies the storage system of the entity data.

↳ format Google\Cloud\Dataplex\V1\StorageFormat

Required. Identifies the storage format of the entity data. It does not apply to entities with data stored in BigQuery.

↳ compatibility Google\Cloud\Dataplex\V1\Entity\CompatibilityStatus

Output only. Metadata stores that the entity is compatible with.

↳ access Google\Cloud\Dataplex\V1\StorageAccess

Output only. Identifies the access mechanism to the entity. Not user settable.

↳ uid string

Output only. System generated unique ID for the Entity. This ID will be different if the Entity is deleted and re-created with the same name.

↳ schema Google\Cloud\Dataplex\V1\Schema

Required. The description of the data structure and layout. The schema is not included in list responses. It is only included in SCHEMA and FULL entity views of a GetEntity response.

getName

Output only. The resource name of the entity, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{id}.

Returns
TypeDescription
string

setName

Output only. The resource name of the entity, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{id}.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDisplayName

Optional. Display name must be shorter than or equal to 256 characters.

Returns
TypeDescription
string

setDisplayName

Optional. Display name must be shorter than or equal to 256 characters.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDescription

Optional. User friendly longer description text. Must be shorter than or equal to 1024 characters.

Returns
TypeDescription
string

setDescription

Optional. User friendly longer description text. Must be shorter than or equal to 1024 characters.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getCreateTime

Output only. The time when the entity was created.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasCreateTime

clearCreateTime

setCreateTime

Output only. The time when the entity was created.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getUpdateTime

Output only. The time when the entity was last updated.

Returns
TypeDescription
Google\Protobuf\Timestamp|null

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. The time when the entity was last updated.

Parameter
NameDescription
var Google\Protobuf\Timestamp
Returns
TypeDescription
$this

getId

Required. A user-provided entity ID. It is mutable, and will be used as the published table name. Specifying a new ID in an update entity request will override the existing value.

The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores, and consist of 256 or fewer characters.

Returns
TypeDescription
string

setId

Required. A user-provided entity ID. It is mutable, and will be used as the published table name. Specifying a new ID in an update entity request will override the existing value.

The ID must contain only letters (a-z, A-Z), numbers (0-9), and underscores, and consist of 256 or fewer characters.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getEtag

Optional. The etag associated with the entity, which can be retrieved with a GetEntity request. Required for update and delete requests.

Returns
TypeDescription
string

setEtag

Optional. The etag associated with the entity, which can be retrieved with a GetEntity request. Required for update and delete requests.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getType

Required. Immutable. The type of entity.

Returns
TypeDescription
int

setType

Required. Immutable. The type of entity.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getAsset

Required. Immutable. The ID of the asset associated with the storage location containing the entity data. The entity must be with in the same zone with the asset.

Returns
TypeDescription
string

setAsset

Required. Immutable. The ID of the asset associated with the storage location containing the entity data. The entity must be with in the same zone with the asset.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDataPath

Required. Immutable. The storage path of the entity data.

For Cloud Storage data, this is the fully-qualified path to the entity, such as gs://bucket/path/to/data. For BigQuery data, this is the name of the table resource, such as projects/project_id/datasets/dataset_id/tables/table_id.

Returns
TypeDescription
string

setDataPath

Required. Immutable. The storage path of the entity data.

For Cloud Storage data, this is the fully-qualified path to the entity, such as gs://bucket/path/to/data. For BigQuery data, this is the name of the table resource, such as projects/project_id/datasets/dataset_id/tables/table_id.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getDataPathPattern

Optional. The set of items within the data path constituting the data in the entity, represented as a glob path. Example: gs://bucket/path/to/data/**/*.csv.

Returns
TypeDescription
string

setDataPathPattern

Optional. The set of items within the data path constituting the data in the entity, represented as a glob path. Example: gs://bucket/path/to/data/**/*.csv.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getCatalogEntry

Output only. The name of the associated Data Catalog entry.

Returns
TypeDescription
string

setCatalogEntry

Output only. The name of the associated Data Catalog entry.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getSystem

Required. Immutable. Identifies the storage system of the entity data.

Returns
TypeDescription
int

setSystem

Required. Immutable. Identifies the storage system of the entity data.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getFormat

Required. Identifies the storage format of the entity data.

It does not apply to entities with data stored in BigQuery.

Returns
TypeDescription
Google\Cloud\Dataplex\V1\StorageFormat|null

hasFormat

clearFormat

setFormat

Required. Identifies the storage format of the entity data.

It does not apply to entities with data stored in BigQuery.

Parameter
NameDescription
var Google\Cloud\Dataplex\V1\StorageFormat
Returns
TypeDescription
$this

getCompatibility

Output only. Metadata stores that the entity is compatible with.

Returns
TypeDescription
Google\Cloud\Dataplex\V1\Entity\CompatibilityStatus|null

hasCompatibility

clearCompatibility

setCompatibility

Output only. Metadata stores that the entity is compatible with.

Parameter
NameDescription
var Google\Cloud\Dataplex\V1\Entity\CompatibilityStatus
Returns
TypeDescription
$this

getAccess

Output only. Identifies the access mechanism to the entity. Not user settable.

Returns
TypeDescription
Google\Cloud\Dataplex\V1\StorageAccess|null

hasAccess

clearAccess

setAccess

Output only. Identifies the access mechanism to the entity. Not user settable.

Parameter
NameDescription
var Google\Cloud\Dataplex\V1\StorageAccess
Returns
TypeDescription
$this

getUid

Output only. System generated unique ID for the Entity. This ID will be different if the Entity is deleted and re-created with the same name.

Returns
TypeDescription
string

setUid

Output only. System generated unique ID for the Entity. This ID will be different if the Entity is deleted and re-created with the same name.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getSchema

Required. The description of the data structure and layout.

The schema is not included in list responses. It is only included in SCHEMA and FULL entity views of a GetEntity response.

Returns
TypeDescription
Google\Cloud\Dataplex\V1\Schema|null

hasSchema

clearSchema

setSchema

Required. The description of the data structure and layout.

The schema is not included in list responses. It is only included in SCHEMA and FULL entity views of a GetEntity response.

Parameter
NameDescription
var Google\Cloud\Dataplex\V1\Schema
Returns
TypeDescription
$this