unitycatalog

type AwsIamRole struct {
	// The external ID used in role assumption to prevent confused deputy
	// problem.
	//
	// [Create:IGN].
	ExternalId string `json:"external_id,omitempty"`
	// The Amazon Resource Name (ARN) of the AWS IAM role for S3 data access.
	// [Create:REQ].
	RoleArn string `json:"role_arn,omitempty"`
	// The Amazon Resource Name (ARN) of the AWS IAM user managed by Databricks.
	// This is the identity that is going to assume the AWS IAM role.
	//
	// [Create:IGN].
	UnityCatalogIamArn string `json:"unity_catalog_iam_arn,omitempty"`
}

type AzureServicePrincipal struct {
	// The application ID of the application registration within the referenced
	// AAD tenant. [Create:REQ]
	ApplicationId string `json:"application_id,omitempty"`
	// The client secret generated for the above app ID in AAD. [Create:REQ]
	ClientSecret string `json:"client_secret,omitempty"`
	// The directory ID corresponding to the Azure Active Directory (AAD) tenant
	// of the application. [Create:REQ].
	DirectoryId string `json:"directory_id,omitempty"`
}

type CatalogInfo struct {
	// [Create,Update:IGN] The type of the catalog.
	CatalogType CatalogInfoCatalogType `json:"catalog_type,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Catalog was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Catalog creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Catalog.
	Name string `json:"name,omitempty"`
	// [Create:IGN,Update:OPT] Username of current owner of Catalog.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Catalog.
	Privileges []CatalogInfoPrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// Delta Sharing Catalog specific fields. A Delta Sharing Catalog is a
	// catalog that is based on a Delta share on a remote sharing server.
	// [Create:OPT,Update:IGN] The name of delta sharing provider.
	ProviderName string `json:"provider_name,omitempty"`
	// [Create:OPT,Update: IGN] The name of the share under the share provider.
	ShareName string `json:"share_name,omitempty"`
	// [Create,Update:IGN] Time at which this Catalog was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Catalog.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CatalogInfoCatalogType string

type CatalogInfoPrivilegesItem string

type CatalogsAPI struct {
	// contains filtered or unexported fields
}

type CatalogsService interface {

	// Create a catalog
	//
	// Creates a new catalog instance in the parent Metastore if the caller is a
	// Metastore admin or has the CREATE CATALOG privilege.
	Create(ctx context.Context, request CreateCatalog) (*CreateCatalogResponse, error)

	// Delete a catalog
	//
	// Deletes the catalog that matches the supplied name. The caller must be a
	// Metastore admin or the owner of the catalog.
	Delete(ctx context.Context, request DeleteCatalogRequest) error

	// Get a catalog
	//
	// Gets an array of all catalogs in the current Metastore for which the user
	// is an admin or Catalog owner, or has the USAGE privilege set for their
	// account.
	Get(ctx context.Context, request GetCatalogRequest) (*GetCatalogResponse, error)

	// List catalogs
	//
	// Gets an array of External Locations (ExternalLocationInfo objects) from
	// the Metastore. The caller must be a Metastore admin, is the owner of the
	// External Location, or has privileges to access the External Location.
	//
	// Use ListAll() to get all CatalogInfo instances
	List(ctx context.Context) (*ListCatalogsResponse, error)

	// Update a catalog
	//
	// Updates the catalog that matches the supplied name. The caller must be
	// either the owner of the catalog, or a Metastore admin (when changing the
	// owner field of the catalog).
	Update(ctx context.Context, request UpdateCatalog) error
}

type ColumnInfo struct {
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create:REQ Update:OPT] Name of Column.
	Name string `json:"name,omitempty"`
	// [Create,Update:OPT] Whether field may be Null (default: True).
	Nullable bool `json:"nullable,omitempty"`
	// [Create,Update:OPT] Partition index for column.
	PartitionIndex int `json:"partition_index,omitempty"`
	// [Create:REQ Update:OPT] Ordinal position of column (starting at position
	// 0).
	Position int `json:"position,omitempty"`
	// [Create: OPT, Update: OPT] Format of IntervalType.
	TypeIntervalType string `json:"type_interval_type,omitempty"`
	// [Create:OPT Update:OPT] Full data type spec, JSON-serialized.
	TypeJson string `json:"type_json,omitempty"`
	// [Create: REQ Update: OPT] Name of type (INT, STRUCT, MAP, etc.)
	TypeName ColumnInfoTypeName `json:"type_name,omitempty"`
	// [Create: OPT, Update: OPT] Digits of precision; required on Create for
	// DecimalTypes.
	TypePrecision int `json:"type_precision,omitempty"`
	// [Create: OPT, Update: OPT] Digits to right of decimal; Required on Create
	// for DecimalTypes.
	TypeScale int `json:"type_scale,omitempty"`
	// [Create:REQ Update:OPT] Full data type spec, SQL/catalogString text.
	TypeText string `json:"type_text,omitempty"`
}

type ColumnInfoTypeName string

type CreateCatalog struct {
	// User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// Name of Catalog
	Name string `json:"name"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// Delta Sharing Catalog specific fields. A Delta Sharing Catalog is a
	// catalog that is based on a Delta share on a remote sharing server.
	// [Create:OPT,Update:IGN] The name of delta sharing provider.
	ProviderName string `json:"provider_name,omitempty"`
	// The name of the share under the share provider.
	ShareName string `json:"share_name,omitempty"`
}

type CreateCatalogResponse struct {
	// [Create,Update:IGN] The type of the catalog.
	CatalogType CreateCatalogResponseCatalogType `json:"catalog_type,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Catalog was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Catalog creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Catalog.
	Name string `json:"name,omitempty"`
	// [Create:IGN,Update:OPT] Username of current owner of Catalog.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Catalog.
	Privileges []CreateCatalogResponsePrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// Delta Sharing Catalog specific fields. A Delta Sharing Catalog is a
	// catalog that is based on a Delta share on a remote sharing server.
	// [Create:OPT,Update:IGN] The name of delta sharing provider.
	ProviderName string `json:"provider_name,omitempty"`
	// [Create:OPT,Update: IGN] The name of the share under the share provider.
	ShareName string `json:"share_name,omitempty"`
	// [Create,Update:IGN] Time at which this Catalog was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Catalog.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateCatalogResponseCatalogType string

type CreateCatalogResponsePrivilegesItem string

type CreateExternalLocation struct {
	// [Create:OPT Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this External Location was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of External Location creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the location's Storage Credential.
	CredentialId string `json:"credential_id,omitempty"`
	// [Create:REQ Update:OPT] Current name of the Storage Credential this
	// location uses.
	CredentialName string `json:"credential_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore hosting the External
	// Location.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of the External Location.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the External Location.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Time at which this was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the External
	// Location.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create:REQ Update:OPT] Path URL of the External Location.
	Url string `json:"url,omitempty"`
}

type CreateExternalLocationResponse struct {
	// [Create:OPT Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this External Location was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of External Location creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the location's Storage Credential.
	CredentialId string `json:"credential_id,omitempty"`
	// [Create:REQ Update:OPT] Current name of the Storage Credential this
	// location uses.
	CredentialName string `json:"credential_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore hosting the External
	// Location.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of the External Location.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the External Location.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Time at which this was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the External
	// Location.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create:REQ Update:OPT] Path URL of the External Location.
	Url string `json:"url,omitempty"`
}

type CreateMetastore struct {
	// [Create,Update:IGN] Time at which this Metastore was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Metastore creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:IGN Update:OPT] Unique identifier of (Default) Data Access
	// Configuration
	DefaultDataAccessConfigId string `json:"default_data_access_config_id,omitempty"`
	// [Create:IGN Update:OPT] Whether Delta Sharing is enabled on this
	// metastore.
	DeltaSharingEnabled bool `json:"delta_sharing_enabled,omitempty"`
	// [Create:IGN Update:OPT] The lifetime of delta sharing recipient token in
	// seconds
	DeltaSharingRecipientTokenLifetimeInSeconds int `json:"delta_sharing_recipient_token_lifetime_in_seconds,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the metastore.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Metastore.
	Privileges []CreateMetastorePrivilegesItem `json:"privileges,omitempty"`
	// The region this metastore has an afinity to. This is used by
	// accounts-manager. Ignored by Unity Catalog.
	Region string `json:"region,omitempty"`
	// [Create:REQ Update:ERR] Storage root URL for Metastore
	StorageRoot string `json:"storage_root,omitempty"`
	// [Create:IGN Update:OPT] UUID of storage credential to access storage_root
	StorageRootCredentialId string `json:"storage_root_credential_id,omitempty"`
	// [Create,Update:IGN] Time at which the Metastore was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Metastore.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateMetastoreAssignment struct {
	// THe name of the default catalog in the Metastore.
	DefaultCatalogName string `json:"default_catalog_name"`
	// The ID of the Metastore.
	MetastoreId string `json:"metastore_id"`
	// A workspace ID.
	WorkspaceId int `json:"-" url:"-"`
}

type CreateMetastorePrivilegesItem string

type CreateMetastoreResponse struct {
	// [Create,Update:IGN] Time at which this Metastore was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Metastore creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:IGN Update:OPT] Unique identifier of (Default) Data Access
	// Configuration
	DefaultDataAccessConfigId string `json:"default_data_access_config_id,omitempty"`
	// [Create:IGN Update:OPT] Whether Delta Sharing is enabled on this
	// metastore.
	DeltaSharingEnabled bool `json:"delta_sharing_enabled,omitempty"`
	// [Create:IGN Update:OPT] The lifetime of delta sharing recipient token in
	// seconds
	DeltaSharingRecipientTokenLifetimeInSeconds int `json:"delta_sharing_recipient_token_lifetime_in_seconds,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the metastore.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Metastore.
	Privileges []CreateMetastoreResponsePrivilegesItem `json:"privileges,omitempty"`
	// The region this metastore has an afinity to. This is used by
	// accounts-manager. Ignored by Unity Catalog.
	Region string `json:"region,omitempty"`
	// [Create:REQ Update:ERR] Storage root URL for Metastore
	StorageRoot string `json:"storage_root,omitempty"`
	// [Create:IGN Update:OPT] UUID of storage credential to access storage_root
	StorageRootCredentialId string `json:"storage_root_credential_id,omitempty"`
	// [Create,Update:IGN] Time at which the Metastore was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Metastore.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateMetastoreResponsePrivilegesItem string

type CreateProvider struct {
	// [Create,Update:IGN] Whether this provider is successfully activated by
	// the data provider. This field is only present when the authentication
	// type is DATABRICKS.
	ActivatedByProvider bool `json:"activated_by_provider,omitempty"`
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType CreateProviderAuthenticationType `json:"authentication_type,omitempty"`
	// [Create,Update:OPT] Description about the provider.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Provider creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:REQ] The name of the Provider.
	Name string `json:"name,omitempty"`
	// [Create,Update:IGN] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfile *RecipientProfile `json:"recipient_profile,omitempty"`
	// [Create,Update:OPT] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfileStr string `json:"recipient_profile_str,omitempty"`
	// [Create,Update:IGN] The server-generated one-time sharing code. This
	// field is only present when the authentication type is DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Share.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateProviderAuthenticationType string

type CreateProviderResponse struct {
	// [Create,Update:IGN] Whether this provider is successfully activated by
	// the data provider. This field is only present when the authentication
	// type is DATABRICKS.
	ActivatedByProvider bool `json:"activated_by_provider,omitempty"`
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType CreateProviderResponseAuthenticationType `json:"authentication_type,omitempty"`
	// [Create,Update:OPT] Description about the provider.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Provider creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:REQ] The name of the Provider.
	Name string `json:"name,omitempty"`
	// [Create,Update:IGN] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfile *RecipientProfile `json:"recipient_profile,omitempty"`
	// [Create,Update:OPT] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfileStr string `json:"recipient_profile_str,omitempty"`
	// [Create,Update:IGN] The server-generated one-time sharing code. This
	// field is only present when the authentication type is DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Share.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateProviderResponseAuthenticationType string

type CreateRecipient struct {
	// [Create:IGN,Update:IGN] A boolean status field showing whether the
	// Recipient's activation URL has been exercised or not.
	Activated bool `json:"activated,omitempty"`
	// [Create:IGN,Update:IGN] Full activation url to retrieve the access token.
	// It will be empty if the token is already retrieved.
	ActivationUrl string `json:"activation_url,omitempty"`
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType CreateRecipientAuthenticationType `json:"authentication_type,omitempty"`
	// [Create:OPT,Update:OPT] Description about the recipient.
	Comment string `json:"comment,omitempty"`
	// [Create:IGN,Update:IGN] Time at which this recipient was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:OPT,Update:OPT] IP Access List
	IpAccessList *IpAccessList `json:"ip_access_list,omitempty"`
	// [Create:REQ,Update:OPT] Name of Recipient.
	Name string `json:"name,omitempty"`
	// [Create:OPT,Update:IGN] The one-time sharing code provided by the data
	// recipient. This field is only present when the authentication type is
	// DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create:IGN,Update:IGN] recipient Tokens This field is only present when
	// the authentication type is TOKEN.
	Tokens []RecipientTokenInfo `json:"tokens,omitempty"`
	// [Create:IGN,Update:IGN] Time at which the recipient was updated, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient updater.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateRecipientAuthenticationType string

type CreateRecipientResponse struct {
	// [Create:IGN,Update:IGN] A boolean status field showing whether the
	// Recipient's activation URL has been exercised or not.
	Activated bool `json:"activated,omitempty"`
	// [Create:IGN,Update:IGN] Full activation url to retrieve the access token.
	// It will be empty if the token is already retrieved.
	ActivationUrl string `json:"activation_url,omitempty"`
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType CreateRecipientResponseAuthenticationType `json:"authentication_type,omitempty"`
	// [Create:OPT,Update:OPT] Description about the recipient.
	Comment string `json:"comment,omitempty"`
	// [Create:IGN,Update:IGN] Time at which this recipient was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:OPT,Update:OPT] IP Access List
	IpAccessList *IpAccessList `json:"ip_access_list,omitempty"`
	// [Create:REQ,Update:OPT] Name of Recipient.
	Name string `json:"name,omitempty"`
	// [Create:OPT,Update:IGN] The one-time sharing code provided by the data
	// recipient. This field is only present when the authentication type is
	// DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create:IGN,Update:IGN] recipient Tokens This field is only present when
	// the authentication type is TOKEN.
	Tokens []RecipientTokenInfo `json:"tokens,omitempty"`
	// [Create:IGN,Update:IGN] Time at which the recipient was updated, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient updater.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateRecipientResponseAuthenticationType string

type CreateSchema struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Schema creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Full name of Schema, in form of
	// <catalog_name>.<schema_name>.
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Schema, relative to parent Catalog.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of Schema.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Schema.
	Privileges []CreateSchemaPrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Schema.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateSchemaPrivilegesItem string

type CreateSchemaResponse struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Schema creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Full name of Schema, in form of
	// <catalog_name>.<schema_name>.
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Schema, relative to parent Catalog.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of Schema.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Schema.
	Privileges []CreateSchemaResponsePrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Schema.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateSchemaResponsePrivilegesItem string

type CreateShare struct {
	// [Create: OPT] comment when creating the share
	Comment string `json:"comment,omitempty"`
	// [Create:IGN] Time at which this Share was created, in epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN] Username of Share creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:REQ] Name of the Share.
	Name string `json:"name,omitempty"`
	// [Create: IGN] A list of shared data objects within the Share.
	Objects []SharedDataObject `json:"objects,omitempty"`
}

type CreateShareResponse struct {
	// [Create: OPT] comment when creating the share
	Comment string `json:"comment,omitempty"`
	// [Create:IGN] Time at which this Share was created, in epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN] Username of Share creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:REQ] Name of the Share.
	Name string `json:"name,omitempty"`
	// [Create: IGN] A list of shared data objects within the Share.
	Objects []SharedDataObject `json:"objects,omitempty"`
}

type CreateStagingTable struct {
	// [Create:REQ] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// [Create:IGN] Unique id generated for the staging table
	Id string `json:"id,omitempty"`
	// [Create:REQ] Name of Table, relative to parent Schema.
	Name string `json:"name,omitempty"`
	// [Create:REQ] Name of parent Schema relative to its parent Catalog.
	SchemaName string `json:"schema_name,omitempty"`
	// [Create:IGN] URI generated for the staging table
	StagingLocation string `json:"staging_location,omitempty"`
}

type CreateStagingTableResponse struct {
	// [Create:REQ] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// [Create:IGN] Unique id generated for the staging table
	Id string `json:"id,omitempty"`
	// [Create:REQ] Name of Table, relative to parent Schema.
	Name string `json:"name,omitempty"`
	// [Create:REQ] Name of parent Schema relative to its parent Catalog.
	SchemaName string `json:"schema_name,omitempty"`
	// [Create:IGN] URI generated for the staging table
	StagingLocation string `json:"staging_location,omitempty"`
}

type CreateStorageCredential struct {
	// The AWS IAM role configuration.
	AwsIamRole *AwsIamRole `json:"aws_iam_role,omitempty"`
	// The Azure service principal configuration.
	AzureServicePrincipal *AzureServicePrincipal `json:"azure_service_principal,omitempty"`
	// [Create,Update:OPT] Comment associated with the credential.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Credential was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of credential creator.
	CreatedBy string `json:"created_by,omitempty"`
	// The GCP service account key configuration.
	GcpServiceAccountKey *GcpServiceAccountKey `json:"gcp_service_account_key,omitempty"`
	// [Create:IGN] The unique identifier of the credential.
	Id string `json:"id,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ, Update:OPT] The credential name. The name MUST be unique
	// within the Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of credential.
	Owner string `json:"owner,omitempty"`
	// Optional. Supplying true to this argument skips validation of the created
	// set of credentials.
	SkipValidation bool `json:"skip_validation,omitempty"`
	// [Create,Update:IGN] Time at which this credential was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the credential.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateStorageCredentialResponse struct {
	// The AWS IAM role configuration.
	AwsIamRole *AwsIamRole `json:"aws_iam_role,omitempty"`
	// The Azure service principal configuration.
	AzureServicePrincipal *AzureServicePrincipal `json:"azure_service_principal,omitempty"`
	// [Create,Update:OPT] Comment associated with the credential.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Credential was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of credential creator.
	CreatedBy string `json:"created_by,omitempty"`
	// The GCP service account key configuration.
	GcpServiceAccountKey *GcpServiceAccountKey `json:"gcp_service_account_key,omitempty"`
	// [Create:IGN] The unique identifier of the credential.
	Id string `json:"id,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ, Update:OPT] The credential name. The name MUST be unique
	// within the Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of credential.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Time at which this credential was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the credential.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type CreateTable struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// This name ('columns') is what the client actually sees as the field name
	// in messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Columns []ColumnInfo `json:"columns,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Table was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Table creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the data_access_configuration to use.
	DataAccessConfigurationId string `json:"data_access_configuration_id,omitempty"`
	// [Create:REQ Update:OPT] Data source format ("DELTA", "CSV", etc.).
	DataSourceFormat CreateTableDataSourceFormat `json:"data_source_format,omitempty"`
	// [Create,Update:IGN] Full name of Table, in form of
	// <catalog_name>.<schema_name>.<table_name>
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Table, relative to parent Schema.
	Name string `json:"name,omitempty"`
	// [Create: IGN Update:OPT] Username of current owner of Table.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Table.
	Privileges []CreateTablePrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create:REQ Update:IGN] Name of parent Schema relative to its parent
	// Catalog.
	SchemaName string `json:"schema_name,omitempty"`
	// [Create,Update:OPT] List of schemes whose objects can be referenced
	// without qualification.
	SqlPath string `json:"sql_path,omitempty"`
	// [Create:OPT Update:IGN] Name of the storage credential this table used
	StorageCredentialName string `json:"storage_credential_name,omitempty"`
	// [Create:REQ Update:OPT] Storage root URL for table (for MANAGED, EXTERNAL
	// tables)
	StorageLocation string `json:"storage_location,omitempty"`
	// [Create:IGN Update:IGN] Name of Table, relative to parent Schema.
	TableId string `json:"table_id,omitempty"`
	// [Create:REQ Update:OPT] Table type ("MANAGED", "EXTERNAL", "VIEW").
	TableType CreateTableTableType `json:"table_type,omitempty"`
	// [Create,Update:IGN] Time at which this Table was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Table.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create,Update:OPT] View definition SQL (when table_type == "VIEW")
	ViewDefinition string `json:"view_definition,omitempty"`
}

type CreateTableDataSourceFormat string

type CreateTablePrivilegesItem string

type CreateTableResponse struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// This name ('columns') is what the client actually sees as the field name
	// in messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Columns []ColumnInfo `json:"columns,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Table was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Table creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the data_access_configuration to use.
	DataAccessConfigurationId string `json:"data_access_configuration_id,omitempty"`
	// [Create:REQ Update:OPT] Data source format ("DELTA", "CSV", etc.).
	DataSourceFormat CreateTableResponseDataSourceFormat `json:"data_source_format,omitempty"`
	// [Create,Update:IGN] Full name of Table, in form of
	// <catalog_name>.<schema_name>.<table_name>
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Table, relative to parent Schema.
	Name string `json:"name,omitempty"`
	// [Create: IGN Update:OPT] Username of current owner of Table.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Table.
	Privileges []CreateTableResponsePrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create:REQ Update:IGN] Name of parent Schema relative to its parent
	// Catalog.
	SchemaName string `json:"schema_name,omitempty"`
	// [Create,Update:OPT] List of schemes whose objects can be referenced
	// without qualification.
	SqlPath string `json:"sql_path,omitempty"`
	// [Create:OPT Update:IGN] Name of the storage credential this table used
	StorageCredentialName string `json:"storage_credential_name,omitempty"`
	// [Create:REQ Update:OPT] Storage root URL for table (for MANAGED, EXTERNAL
	// tables)
	StorageLocation string `json:"storage_location,omitempty"`
	// [Create:IGN Update:IGN] Name of Table, relative to parent Schema.
	TableId string `json:"table_id,omitempty"`
	// [Create:REQ Update:OPT] Table type ("MANAGED", "EXTERNAL", "VIEW").
	TableType CreateTableResponseTableType `json:"table_type,omitempty"`
	// [Create,Update:IGN] Time at which this Table was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Table.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create,Update:OPT] View definition SQL (when table_type == "VIEW")
	ViewDefinition string `json:"view_definition,omitempty"`
}

type CreateTableResponseDataSourceFormat string

type CreateTableResponsePrivilegesItem string

type CreateTableResponseTableType string

type CreateTableTableType string

type DeleteCatalogRequest struct {
	// Required. The name of the catalog.
	Name string `json:"-" url:"-"`
}

type DeleteExternalLocationRequest struct {
	// Force deletion even if there are dependent external tables or mounts.
	Force bool `json:"-" url:"force,omitempty"`
	// Required. Name of the storage credential.
	Name string `json:"-" url:"-"`
}

type DeleteMetastoreRequest struct {
	// Force deletion even if the metastore is not empty. Default is false.
	Force bool `json:"-" url:"force,omitempty"`
	// Required. Unique ID of the Metastore (from URL).
	Id string `json:"-" url:"-"`
}

type DeleteProviderRequest struct {
	// Required. Name of the provider.
	Name string `json:"-" url:"-"`
}

type DeleteRecipientRequest struct {
	// Required. Name of the recipient.
	Name string `json:"-" url:"-"`
}

type DeleteSchemaRequest struct {
	// Required. Full name of the schema (from URL).
	FullName string `json:"-" url:"-"`
}

type DeleteShareRequest struct {
	// The name of the share.
	Name string `json:"-" url:"-"`
}

type DeleteStorageCredentialRequest struct {
	// Force deletion even if there are dependent external locations or external
	// tables.
	Force bool `json:"-" url:"force,omitempty"`
	// Required. Name of the storage credential.
	Name string `json:"-" url:"-"`
}

type DeleteTableRequest struct {
	// Required. Full name of the Table (from URL).
	FullName string `json:"-" url:"-"`
}

type ExternalLocationInfo struct {
	// [Create:OPT Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this External Location was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of External Location creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the location's Storage Credential.
	CredentialId string `json:"credential_id,omitempty"`
	// [Create:REQ Update:OPT] Current name of the Storage Credential this
	// location uses.
	CredentialName string `json:"credential_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore hosting the External
	// Location.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of the External Location.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the External Location.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Time at which this was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the External
	// Location.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create:REQ Update:OPT] Path URL of the External Location.
	Url string `json:"url,omitempty"`
}

type ExternalLocationsAPI struct {
	// contains filtered or unexported fields
}

type ExternalLocationsService interface {

	// Create an external location
	//
	// Creates a new External Location entry in the Metastore. The caller must
	// be a Metastore admin or have the CREATE EXTERNAL LOCATION privilege on
	// the Metastore.
	Create(ctx context.Context, request CreateExternalLocation) (*CreateExternalLocationResponse, error)

	// Delete an external location
	//
	// Deletes the specified external location from the Metastore. The caller
	// must be the owner of the external location.
	Delete(ctx context.Context, request DeleteExternalLocationRequest) error

	// Get an external location
	//
	// Gets an external location from the Metastore. The caller must be either a
	// Metastore admin, the owner of the external location, or has an
	// appropriate privilege level on the Metastore.
	Get(ctx context.Context, request GetExternalLocationRequest) (*GetExternalLocationResponse, error)

	// List external locations
	//
	// Gets an array of External Locations (ExternalLocationInfo objects) from
	// the Metastore. The caller must be a Metastore admin, is the owner of the
	// external location, or has privileges to access the external location.
	//
	// Use ListAll() to get all ExternalLocationInfo instances
	List(ctx context.Context) (*ListExternalLocationsResponse, error)

	// Update an external location
	//
	// Updates an external location in the Metastore. The caller must be the
	// owner of the externa location, or be a Metastore admin. In the second
	// case, the admin can only update the name of the external location.
	Update(ctx context.Context, request UpdateExternalLocation) error
}

type GcpServiceAccountKey struct {
	// The email of the service account. [Create:REQ].
	Email string `json:"email,omitempty"`
	// The service account's RSA private key. [Create:REQ]
	PrivateKey string `json:"private_key,omitempty"`
	// The ID of the service account's private key. [Create:REQ]
	PrivateKeyId string `json:"private_key_id,omitempty"`
}

type GetActivationUrlInfoRequest struct {
	// Required. The one time activation url. It also accepts activation token.
	ActivationUrl string `json:"-" url:"-"`
}

type GetCatalogRequest struct {
	// Required. The name of the catalog.
	Name string `json:"-" url:"-"`
}

type GetCatalogResponse struct {
	// [Create,Update:IGN] The type of the catalog.
	CatalogType GetCatalogResponseCatalogType `json:"catalog_type,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Catalog was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Catalog creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Catalog.
	Name string `json:"name,omitempty"`
	// [Create:IGN,Update:OPT] Username of current owner of Catalog.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Catalog.
	Privileges []GetCatalogResponsePrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// Delta Sharing Catalog specific fields. A Delta Sharing Catalog is a
	// catalog that is based on a Delta share on a remote sharing server.
	// [Create:OPT,Update:IGN] The name of delta sharing provider.
	ProviderName string `json:"provider_name,omitempty"`
	// [Create:OPT,Update: IGN] The name of the share under the share provider.
	ShareName string `json:"share_name,omitempty"`
	// [Create,Update:IGN] Time at which this Catalog was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Catalog.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type GetCatalogResponseCatalogType string

type GetCatalogResponsePrivilegesItem string

type GetExternalLocationRequest struct {
	// Required. Name of the storage credential.
	Name string `json:"-" url:"-"`
}

type GetExternalLocationResponse struct {
	// [Create:OPT Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this External Location was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of External Location creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the location's Storage Credential.
	CredentialId string `json:"credential_id,omitempty"`
	// [Create:REQ Update:OPT] Current name of the Storage Credential this
	// location uses.
	CredentialName string `json:"credential_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore hosting the External
	// Location.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of the External Location.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the External Location.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Time at which this was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the External
	// Location.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create:REQ Update:OPT] Path URL of the External Location.
	Url string `json:"url,omitempty"`
}

type GetGrantRequest struct {
	// Required. Unique identifier (full name) of Securable (from URL).
	FullName string `json:"-" url:"-"`
	// Optional. List permissions granted to this principal.
	Principal string `json:"-" url:"principal,omitempty"`
	// Required. Type of Securable (from URL).
	SecurableType string `json:"-" url:"-"`
}

type GetMetastoreRequest struct {
	// Required. Unique ID of the Metastore (from URL).
	Id string `json:"-" url:"-"`
}

type GetMetastoreResponse struct {
	// [Create,Update:IGN] Time at which this Metastore was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Metastore creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:IGN Update:OPT] Unique identifier of (Default) Data Access
	// Configuration
	DefaultDataAccessConfigId string `json:"default_data_access_config_id,omitempty"`
	// [Create:IGN Update:OPT] Whether Delta Sharing is enabled on this
	// metastore.
	DeltaSharingEnabled bool `json:"delta_sharing_enabled,omitempty"`
	// [Create:IGN Update:OPT] The lifetime of delta sharing recipient token in
	// seconds
	DeltaSharingRecipientTokenLifetimeInSeconds int `json:"delta_sharing_recipient_token_lifetime_in_seconds,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the metastore.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Metastore.
	Privileges []GetMetastoreResponsePrivilegesItem `json:"privileges,omitempty"`
	// The region this metastore has an afinity to. This is used by
	// accounts-manager. Ignored by Unity Catalog.
	Region string `json:"region,omitempty"`
	// [Create:REQ Update:ERR] Storage root URL for Metastore
	StorageRoot string `json:"storage_root,omitempty"`
	// [Create:IGN Update:OPT] UUID of storage credential to access storage_root
	StorageRootCredentialId string `json:"storage_root_credential_id,omitempty"`
	// [Create,Update:IGN] Time at which the Metastore was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Metastore.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type GetMetastoreResponsePrivilegesItem string

type GetMetastoreSummaryResponse struct {
	// Unique identifier of the Metastore's (Default) Data Access Configuration
	DefaultDataAccessConfigId string `json:"default_data_access_config_id,omitempty"`
	// The unique ID (UUID) of the Metastore
	MetastoreId string `json:"metastore_id,omitempty"`
	// The user-specified name of the Metastore
	Name string `json:"name,omitempty"`
	// UUID of storage credential to access the metastore storage_root
	StorageRootCredentialId string `json:"storage_root_credential_id,omitempty"`
}

type GetPermissionsResponse struct {
	// Note to self (acain): Unfortunately, neither json_inline nor json_map
	// work here.
	PrivilegeAssignments []PrivilegeAssignment `json:"privilege_assignments,omitempty"`
}

type GetProviderRequest struct {
	// Required. Name of the provider.
	Name string `json:"-" url:"-"`
}

type GetProviderResponse struct {
	// [Create,Update:IGN] Whether this provider is successfully activated by
	// the data provider. This field is only present when the authentication
	// type is DATABRICKS.
	ActivatedByProvider bool `json:"activated_by_provider,omitempty"`
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType GetProviderResponseAuthenticationType `json:"authentication_type,omitempty"`
	// [Create,Update:OPT] Description about the provider.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Provider creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:REQ] The name of the Provider.
	Name string `json:"name,omitempty"`
	// [Create,Update:IGN] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfile *RecipientProfile `json:"recipient_profile,omitempty"`
	// [Create,Update:OPT] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfileStr string `json:"recipient_profile_str,omitempty"`
	// [Create,Update:IGN] The server-generated one-time sharing code. This
	// field is only present when the authentication type is DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Share.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type GetProviderResponseAuthenticationType string

type GetRecipientRequest struct {
	// Required. Name of the recipient.
	Name string `json:"-" url:"-"`
}

type GetRecipientResponse struct {
	// [Create:IGN,Update:IGN] A boolean status field showing whether the
	// Recipient's activation URL has been exercised or not.
	Activated bool `json:"activated,omitempty"`
	// [Create:IGN,Update:IGN] Full activation url to retrieve the access token.
	// It will be empty if the token is already retrieved.
	ActivationUrl string `json:"activation_url,omitempty"`
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType GetRecipientResponseAuthenticationType `json:"authentication_type,omitempty"`
	// [Create:OPT,Update:OPT] Description about the recipient.
	Comment string `json:"comment,omitempty"`
	// [Create:IGN,Update:IGN] Time at which this recipient was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:OPT,Update:OPT] IP Access List
	IpAccessList *IpAccessList `json:"ip_access_list,omitempty"`
	// [Create:REQ,Update:OPT] Name of Recipient.
	Name string `json:"name,omitempty"`
	// [Create:OPT,Update:IGN] The one-time sharing code provided by the data
	// recipient. This field is only present when the authentication type is
	// DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create:IGN,Update:IGN] recipient Tokens This field is only present when
	// the authentication type is TOKEN.
	Tokens []RecipientTokenInfo `json:"tokens,omitempty"`
	// [Create:IGN,Update:IGN] Time at which the recipient was updated, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient updater.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type GetRecipientResponseAuthenticationType string

type GetRecipientSharePermissionsResponse struct {
	// An array of data share permissions for a recipient.
	PermissionsOut []ShareToPrivilegeAssignment `json:"permissions_out,omitempty"`
}

type GetSchemaRequest struct {
	// Required. Full name of the schema (from URL).
	FullName string `json:"-" url:"-"`
}

type GetSchemaResponse struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Schema creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Full name of Schema, in form of
	// <catalog_name>.<schema_name>.
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Schema, relative to parent Catalog.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of Schema.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Schema.
	Privileges []GetSchemaResponsePrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Schema.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type GetSchemaResponsePrivilegesItem string

type GetSharePermissionsResponse struct {
	// Note to self (acain): Unfortunately, neither json_inline nor json_map
	// work here.
	PrivilegeAssignments []PrivilegeAssignment `json:"privilege_assignments,omitempty"`
}

type GetShareRequest struct {
	// Query for data to include in the share.
	IncludeSharedData bool `json:"-" url:"include_shared_data,omitempty"`
	// The name of the share.
	Name string `json:"-" url:"-"`
}

type GetShareResponse struct {
	// [Create: OPT] comment when creating the share
	Comment string `json:"comment,omitempty"`
	// [Create:IGN] Time at which this Share was created, in epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN] Username of Share creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:REQ] Name of the Share.
	Name string `json:"name,omitempty"`
	// [Create: IGN] A list of shared data objects within the Share.
	Objects []SharedDataObject `json:"objects,omitempty"`
}

type GetStorageCredentialRequest struct {
	// Required. Name of the storage credential.
	Name string `json:"-" url:"-"`
}

type GetStorageCredentialResponse struct {
	// The AWS IAM role configuration.
	AwsIamRole *AwsIamRole `json:"aws_iam_role,omitempty"`
	// The Azure service principal configuration.
	AzureServicePrincipal *AzureServicePrincipal `json:"azure_service_principal,omitempty"`
	// [Create,Update:OPT] Comment associated with the credential.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Credential was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of credential creator.
	CreatedBy string `json:"created_by,omitempty"`
	// The GCP service account key configuration.
	GcpServiceAccountKey *GcpServiceAccountKey `json:"gcp_service_account_key,omitempty"`
	// [Create:IGN] The unique identifier of the credential.
	Id string `json:"id,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ, Update:OPT] The credential name. The name MUST be unique
	// within the Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of credential.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Time at which this credential was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the credential.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type GetTableRequest struct {
	// Required. Full name of the Table (from URL).
	FullName string `json:"-" url:"-"`
}

type GetTableResponse struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// This name ('columns') is what the client actually sees as the field name
	// in messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Columns []ColumnInfo `json:"columns,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Table was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Table creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the data_access_configuration to use.
	DataAccessConfigurationId string `json:"data_access_configuration_id,omitempty"`
	// [Create:REQ Update:OPT] Data source format ("DELTA", "CSV", etc.).
	DataSourceFormat GetTableResponseDataSourceFormat `json:"data_source_format,omitempty"`
	// [Create,Update:IGN] Full name of Table, in form of
	// <catalog_name>.<schema_name>.<table_name>
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Table, relative to parent Schema.
	Name string `json:"name,omitempty"`
	// [Create: IGN Update:OPT] Username of current owner of Table.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Table.
	Privileges []GetTableResponsePrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create:REQ Update:IGN] Name of parent Schema relative to its parent
	// Catalog.
	SchemaName string `json:"schema_name,omitempty"`
	// [Create,Update:OPT] List of schemes whose objects can be referenced
	// without qualification.
	SqlPath string `json:"sql_path,omitempty"`
	// [Create:OPT Update:IGN] Name of the storage credential this table used
	StorageCredentialName string `json:"storage_credential_name,omitempty"`
	// [Create:REQ Update:OPT] Storage root URL for table (for MANAGED, EXTERNAL
	// tables)
	StorageLocation string `json:"storage_location,omitempty"`
	// [Create:IGN Update:IGN] Name of Table, relative to parent Schema.
	TableId string `json:"table_id,omitempty"`
	// [Create:REQ Update:OPT] Table type ("MANAGED", "EXTERNAL", "VIEW").
	TableType GetTableResponseTableType `json:"table_type,omitempty"`
	// [Create,Update:IGN] Time at which this Table was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Table.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create,Update:OPT] View definition SQL (when table_type == "VIEW")
	ViewDefinition string `json:"view_definition,omitempty"`
}

type GetTableResponseDataSourceFormat string

type GetTableResponsePrivilegesItem string

type GetTableResponseTableType string

type GrantsAPI struct {
	// contains filtered or unexported fields
}

type GrantsService interface {

	// Get permissions
	//
	// Gets the permissions for a Securable type.
	Get(ctx context.Context, request GetGrantRequest) (*GetPermissionsResponse, error)

	// Update permissions
	//
	// Updates the permissions for a Securable type.
	Update(ctx context.Context, request UpdatePermissions) error
}

type IpAccessList struct {
	// Allowed IP Addresses in CIDR notation. Limit of 100.
	AllowedIpAddresses []string `json:"allowed_ip_addresses,omitempty"`
}

type ListCatalogsResponse struct {
	// AN array of catalog information objects.
	Catalogs []CatalogInfo `json:"catalogs,omitempty"`
}

type ListExternalLocationsResponse struct {
	// AN array of external locations.
	ExternalLocations []ExternalLocationInfo `json:"external_locations,omitempty"`
}

type ListMetastoresResponse struct {
	// An array of Metastore information objects.
	Metastores []MetastoreInfo `json:"metastores,omitempty"`
}

type ListProviderSharesResponse struct {
	// An array of provider shares.
	Shares []ProviderShare `json:"shares,omitempty"`
}

type ListProvidersRequest struct {
	// If not provided, all providers will be returned. If no providers exist
	// with this ID, no results will be returned.
	DataProviderGlobalMetastoreId string `json:"-" url:"data_provider_global_metastore_id,omitempty"`
}

type ListProvidersResponse struct {
	// An array of provider information objects.
	Providers []ProviderInfo `json:"providers,omitempty"`
}

type ListRecipientsRequest struct {
	// If not provided, all recipients will be returned. If no recipients exist
	// with this ID, no results will be returned.
	DataRecipientGlobalMetastoreId string `json:"-" url:"data_recipient_global_metastore_id,omitempty"`
}

type ListRecipientsResponse struct {
	// An array of recipient information objects.
	Recipients []RecipientInfo `json:"recipients,omitempty"`
}

type ListSchemasRequest struct {
	// Optional. Parent catalog for schemas of interest.
	CatalogName string `json:"-" url:"catalog_name,omitempty"`
}

type ListSchemasResponse struct {
	// An array of schema information objects.
	Schemas []SchemaInfo `json:"schemas,omitempty"`
}

type ListSharesRequest struct {
	// Required. Name of the provider in which to list shares.
	Name string `json:"-" url:"-"`
}

type ListSharesResponse struct {
	// An array of data share information objects.
	Shares []ShareInfo `json:"shares,omitempty"`
}

type ListStorageCredentialsResponse struct {
	// TODO: add pagination to UC list APIs.
	StorageCredentials []StorageCredentialInfo `json:"storage_credentials,omitempty"`
}

type ListTableSummariesResponse struct {
	// Optional. Opaque token for pagination. Empty if there's no more page.
	NextPageToken string `json:"next_page_token,omitempty"`
	// Only name, catalog_name, schema_name, full_name and table_type will be
	// set.
	Tables []TableSummary `json:"tables,omitempty"`
}

type ListTablesRequest struct {
	// Required. Name of parent catalog for tables of interest.
	CatalogName string `json:"-" url:"catalog_name,omitempty"`
	// Required (for now -- may be optional for wildcard search in future).
	// Parent schema of tables.
	SchemaName string `json:"-" url:"schema_name,omitempty"`
}

type ListTablesResponse struct {
	// An array of table information objects.
	Tables []TableInfo `json:"tables,omitempty"`
}

type MetastoreInfo struct {
	// [Create,Update:IGN] Time at which this Metastore was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Metastore creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:IGN Update:OPT] Unique identifier of (Default) Data Access
	// Configuration
	DefaultDataAccessConfigId string `json:"default_data_access_config_id,omitempty"`
	// [Create:IGN Update:OPT] Whether Delta Sharing is enabled on this
	// metastore.
	DeltaSharingEnabled bool `json:"delta_sharing_enabled,omitempty"`
	// [Create:IGN Update:OPT] The lifetime of delta sharing recipient token in
	// seconds
	DeltaSharingRecipientTokenLifetimeInSeconds int `json:"delta_sharing_recipient_token_lifetime_in_seconds,omitempty"`
	// [Create,Update:IGN] Unique identifier of Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] The owner of the metastore.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Metastore.
	Privileges []MetastoreInfoPrivilegesItem `json:"privileges,omitempty"`
	// The region this metastore has an afinity to. This is used by
	// accounts-manager. Ignored by Unity Catalog.
	Region string `json:"region,omitempty"`
	// [Create:REQ Update:ERR] Storage root URL for Metastore
	StorageRoot string `json:"storage_root,omitempty"`
	// [Create:IGN Update:OPT] UUID of storage credential to access storage_root
	StorageRootCredentialId string `json:"storage_root_credential_id,omitempty"`
	// [Create,Update:IGN] Time at which the Metastore was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Metastore.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type MetastoreInfoPrivilegesItem string

type MetastoresAPI struct {
	// contains filtered or unexported fields
}

type MetastoresService interface {

	// Create an assignment
	//
	// Creates a new Metastore assignment. If an assignment for the same
	// __workspace_id__ exists, it will be overwritten by the new
	// __metastore_id__ and __default_catalog_name__. The caller must be an
	// account admin.
	Assign(ctx context.Context, request CreateMetastoreAssignment) error

	// Create a Metastore
	//
	// Creates a new Metastore based on a provided name and storage root path.
	Create(ctx context.Context, request CreateMetastore) (*CreateMetastoreResponse, error)

	// Delete a Metastore
	//
	// Deletes a Metastore. The caller must be a Metastore admin.
	Delete(ctx context.Context, request DeleteMetastoreRequest) error

	// Get a Metastore
	//
	// Gets a Metastore that matches the supplied ID. The caller must be a
	// Metastore admin to retrieve this info.
	Get(ctx context.Context, request GetMetastoreRequest) (*GetMetastoreResponse, error)

	// List Metastores
	//
	// Gets an array of the available Metastores (as MetastoreInfo objects). The
	// caller must be an admin to retrieve this info.
	//
	// Use ListAll() to get all MetastoreInfo instances
	List(ctx context.Context) (*ListMetastoresResponse, error)

	// Get a summary
	//
	// Gets information about a Metastore. This summary includes the storage
	// credential, the cloud vendor, the cloud region, and the global Metastore
	// ID.
	Summary(ctx context.Context) (*GetMetastoreSummaryResponse, error)

	// Delete an assignment
	//
	// Deletes a Metastore assignment. The caller must be an account
	// administrator.
	Unassign(ctx context.Context, request UnassignRequest) error

	// Update a Metastore
	//
	// Updates information for a specific Metastore. The caller must be a
	// Metastore admin.
	Update(ctx context.Context, request UpdateMetastore) error

	// Update an assignment
	//
	// Updates a Metastore assignment. This operation can be used to update
	// __metastore_id__ or __default_catalog_name__ for a specified Workspace,
	// if the Workspace is already assigned a Metastore. The caller must be an
	// account admin to update __metastore_id__; otherwise, the caller can be a
	// Workspace admin.
	UpdateAssignment(ctx context.Context, request UpdateMetastoreAssignment) error
}

type Partition struct {
	// An array of partition values.
	Values []PartitionValue `json:"values,omitempty"`
}

type PartitionValue struct {
	// The name of the partition column.
	Name string `json:"name,omitempty"`
	// The operator to apply for the value.
	Op PartitionValueOp `json:"op,omitempty"`
	// The key of a Delta Sharing recipient's property. For example
	// "databricks-account-id". When this field is set, field `value` can not be
	// set.
	RecipientPropertyKey string `json:"recipient_property_key,omitempty"`
	// The value of the partition column. When this value is not set, it means
	// `null` value. When this field is set, field `recipient_property_key` can
	// not be set.
	Value string `json:"value,omitempty"`
}

type PartitionValueOp string

type PermissionsChange struct {
	// The set of privileges to add.
	Add []PermissionsChangeAddItem `json:"add,omitempty"`
	// The principal whose privileges we are changing.
	Principal string `json:"principal,omitempty"`
	// The set of privileges to remove.
	Remove []PermissionsChangeRemoveItem `json:"remove,omitempty"`
}

type PermissionsChangeAddItem string

type PermissionsChangeRemoveItem string

type PrivilegeAssignment struct {
	// The principal (user email address or group name).
	Principal string `json:"principal,omitempty"`
	// The privileges assigned to the principal.
	Privileges []PrivilegeAssignmentPrivilegesItem `json:"privileges,omitempty"`
}

type PrivilegeAssignmentPrivilegesItem string

type ProviderInfo struct {
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType ProviderInfoAuthenticationType `json:"authentication_type,omitempty"`
	// [Create:IGN,Update:IGN] Cloud vendor of the provider's UC Metastore. This
	// field is only present when the authentication type is DATABRICKS.
	Cloud string `json:"cloud,omitempty"`
	// [Create,Update:OPT] Description about the provider.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Provider creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:IGN,Update:IGN] The global UC metastore id of the data provider
	// This field is only present when the authentication type is DATABRICKS.
	// The identifier is of format <cloud>:<region>:<metastore-uuid>.
	DataProviderGlobalMetastoreId string `json:"data_provider_global_metastore_id,omitempty"`
	// [Create:IGN,Update:IGN] UUID of the provider's UC Metastore. This field
	// is only present when the authentication type is DATABRICKS.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create,Update:REQ] The name of the Provider.
	Name string `json:"name,omitempty"`
	// [Create,Update:OPT] Username of Provider owner.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfile *RecipientProfile `json:"recipient_profile,omitempty"`
	// [Create,Update:OPT] This field is only present when the authentication
	// type is TOKEN.
	RecipientProfileStr string `json:"recipient_profile_str,omitempty"`
	// [Create:IGN,Update:IGN] Cloud region of the provider's UC Metastore. This
	// field is only present when the authentication type is DATABRICKS.
	Region string `json:"region,omitempty"`
	// [Create,Update:IGN] Time at which this Provider was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Share.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type ProviderInfoAuthenticationType string

type ProviderShare struct {
	// The name of the Provider Share.
	Name string `json:"name,omitempty"`
}

type ProvidersAPI struct {
	// contains filtered or unexported fields
}

type ProvidersService interface {

	// Create an auth provider
	//
	// Creates a new authentication provider minimally based on a name and
	// authentication type. The caller must be an admin on the Metastore.
	Create(ctx context.Context, request CreateProvider) (*CreateProviderResponse, error)

	// Delete a provider
	//
	// Deletes an authentication provider, if the caller is a Metastore admin or
	// is the owner of the provider.
	Delete(ctx context.Context, request DeleteProviderRequest) error

	// Get a provider
	//
	// Gets a specific authentication provider. The caller must supply the name
	// of the provider, and must either be a Metastore admin or the owner of the
	// provider.
	Get(ctx context.Context, request GetProviderRequest) (*GetProviderResponse, error)

	// List providers
	//
	// Gets an array of available authentication providers. The caller must
	// either be a Metastore admin or the owner of the providers. Providers not
	// owned by the caller are not included in the response.
	//
	// Use ListAll() to get all ProviderInfo instances
	List(ctx context.Context, request ListProvidersRequest) (*ListProvidersResponse, error)

	// List shares
	//
	// Gets an array of all shares within the Metastore where:
	//
	// * the caller is a Metastore admin, or * the caller is the owner.
	ListShares(ctx context.Context, request ListSharesRequest) (*ListProviderSharesResponse, error)

	// Update a provider
	//
	// Updates the information for an authentication provider, if the caller is
	// a Metastore admin or is the owner of the provider. If the update changes
	// the provider name, the caller must be both a Metastore admin and the
	// owner of the provider.
	Update(ctx context.Context, request UpdateProvider) error
}

type RecipientActivationAPI struct {
	// contains filtered or unexported fields
}

type RecipientActivationService interface {

	// Get a share activation URL
	//
	// Gets information about an Activation URL.
	GetActivationUrlInfo(ctx context.Context, request GetActivationUrlInfoRequest) error

	// Get an access token
	//
	// RPC to retrieve access token with an activation token. This is a public
	// API without any authentication.
	RetrieveToken(ctx context.Context, request RetrieveTokenRequest) (*RetrieveTokenResponse, error)
}

type RecipientInfo struct {
	// [Create:IGN,Update:IGN] A boolean status field showing whether the
	// Recipient's activation URL has been exercised or not.
	Activated bool `json:"activated,omitempty"`
	// [Create:IGN,Update:IGN] Full activation url to retrieve the access token.
	// It will be empty if the token is already retrieved.
	ActivationUrl string `json:"activation_url,omitempty"`
	// [Create:REQ,Update:IGN] The delta sharing authentication type.
	AuthenticationType RecipientInfoAuthenticationType `json:"authentication_type,omitempty"`
	// [Create:IGN,Update:IGN] Cloud vendor of the recipient's UC Metastore.
	// This field is only present when the authentication type is DATABRICKS.
	Cloud string `json:"cloud,omitempty"`
	// [Create:OPT,Update:OPT] Description about the recipient.
	Comment string `json:"comment,omitempty"`
	// [Create:IGN,Update:IGN] Time at which this recipient was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:OPT,Update:IGN] The global UC metastore id provided by the data
	// recipient. This field is only present when the authentication type is
	// DATABRICKS. The identifier is of format
	// <cloud>:<region>:<metastore-uuid>.
	DataRecipientGlobalMetastoreId string `json:"data_recipient_global_metastore_id,omitempty"`
	// [Create:OPT,Update:OPT] IP Access List
	IpAccessList *IpAccessList `json:"ip_access_list,omitempty"`
	// [Create:IGN,Update:IGN] UUID of the recipient's UC Metastore. This field
	// is only present when the authentication type is DATABRICKS.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ,Update:OPT] Name of Recipient.
	Name string `json:"name,omitempty"`
	// [Create:IGN,Update:OPT] Username of Recipient owner.
	Owner string `json:"owner,omitempty"`
	// [Create:IGN,Update:IGN] Cloud region of the recipient's UC Metastore.
	// This field is only present when the authentication type is DATABRICKS.
	Region string `json:"region,omitempty"`
	// [Create:OPT,Update:IGN] The one-time sharing code provided by the data
	// recipient. This field is only present when the authentication type is
	// DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create:IGN,Update:IGN] Recipient Tokens. This field is only present when
	// the authentication type is TOKEN.
	Tokens []RecipientTokenInfo `json:"tokens,omitempty"`
	// [Create:IGN,Update:IGN] Time at which this recipient was updated, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient updater.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type RecipientInfoAuthenticationType string

type RecipientProfile struct {
	// The token used to authorize the recipient.
	BearerToken string `json:"bearer_token,omitempty"`
	// The endpoint for the share to be used by the recipient.
	Endpoint string `json:"endpoint,omitempty"`
	// The version number of the recipient's credentials on a share.
	ShareCredentialsVersion int `json:"share_credentials_version,omitempty"`
}

type RecipientTokenInfo struct {
	// Full activation URL to retrieve the access token. It will be empty if the
	// token is already retrieved.
	ActivationUrl string `json:"activation_url,omitempty"`
	// Time at which this recipient Token was created, in epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// Username of recipient token creator.
	CreatedBy string `json:"created_by,omitempty"`
	// Expiration timestamp of the token in epoch milliseconds.
	ExpirationTime int64 `json:"expiration_time,omitempty"`
	// Unique ID of the recipient token.
	Id string `json:"id,omitempty"`
	// Time at which this recipient Token was updated, in epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// Username of recipient Token updater.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type RecipientsAPI struct {
	// contains filtered or unexported fields
}

type RecipientsService interface {

	// Create a share recipient
	//
	// Creates a new recipient with the delta sharing authentication type in the
	// Metastore. The caller must be a Metastore admin or has the CREATE
	// RECIPIENT privilege on the Metastore.
	Create(ctx context.Context, request CreateRecipient) (*CreateRecipientResponse, error)

	// Delete a share recipient
	//
	// Deletes the specified recipient from the Metastore. The caller must be
	// the owner of the recipient.
	Delete(ctx context.Context, request DeleteRecipientRequest) error

	// Get a share recipient
	//
	// Gets a share recipient from the Metastore if:
	//
	// * the caller is the owner of the share recipient, or: * is a Metastore
	// admin
	Get(ctx context.Context, request GetRecipientRequest) (*GetRecipientResponse, error)

	// List share recipients
	//
	// Gets an array of all share recipients within the current Metastore where:
	//
	// * the caller is a Metastore admin, or * the caller is the owner.
	//
	// Use ListAll() to get all RecipientInfo instances
	List(ctx context.Context, request ListRecipientsRequest) (*ListRecipientsResponse, error)

	// Rotate a token
	//
	// Refreshes the specified recipient's delta sharing authentication token
	// with the provided token info. The caller must be the owner of the
	// recipient.
	RotateToken(ctx context.Context, request RotateRecipientToken) (*RotateRecipientTokenResponse, error)

	// Get share permissions
	//
	// Gets the share permissions for the specified Recipient. The caller must
	// be a Metastore admin or the owner of the Recipient.
	SharePermissions(ctx context.Context, request SharePermissionsRequest) (*GetRecipientSharePermissionsResponse, error)

	// Update a share recipient
	//
	// Updates an existing recipient in the Metastore. The caller must be a
	// Metastore admin or the owner of the recipient. If the recipient name will
	// be updated, the user must be both a Metastore admin and the owner of the
	// recipient.
	Update(ctx context.Context, request UpdateRecipient) error
}

type RetrieveTokenRequest struct {
	// Required. The one time activation url. It also accepts activation token.
	ActivationUrl string `json:"-" url:"-"`
}

type RetrieveTokenResponse struct {
	// The token used to authorize the recipient.
	BearerToken string `json:"bearerToken,omitempty"`
	// The endpoint for the share to be used by the recipient.
	Endpoint string `json:"endpoint,omitempty"`
	// Expiration timestamp of the token in epoch milliseconds.
	ExpirationTime string `json:"expirationTime,omitempty"`
	// These field names must follow the delta sharing protocol.
	ShareCredentialsVersion int `json:"shareCredentialsVersion,omitempty"`
}

type RotateRecipientToken struct {
	// Required. This will set the expiration_time of existing token only to a
	// smaller timestamp, it cannot extend the expiration_time. Use 0 to expire
	// the existing token immediately, negative number will return an error.
	ExistingTokenExpireInSeconds int64 `json:"existing_token_expire_in_seconds,omitempty"`
	// Required. The name of the recipient.
	Name string `json:"-" url:"-"`
}

type RotateRecipientTokenResponse struct {
	// [Create:IGN, Update:IGN] A boolean status field showing whether the
	// Recipient's activation URL has been exercised or not.
	Activated bool `json:"activated,omitempty"`
	// [Create:IGN, Update:IGN] Full activation url to retrieve the access
	// token. It will be empty if the token is already retrieved.
	ActivationUrl string `json:"activation_url,omitempty"`
	// [Create:REQ, Update:IGN] The delta sharing authentication type.
	AuthenticationType RotateRecipientTokenResponseAuthenticationType `json:"authentication_type,omitempty"`
	// [Create:OPT,Update:OPT] Description about the recipient.
	Comment string `json:"comment,omitempty"`
	// [Create:IGN, Update:IGN] Time at which this recipient was created, in
	// epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN, Update:IGN] Username of recipient creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:OPT,Update:OPT] IP Access List
	IpAccessList *IpAccessList `json:"ip_access_list,omitempty"`
	// [Create:REQ, Update:OPT] Name of Recipient.
	Name string `json:"name,omitempty"`
	// [Create:OPT,Update:IGN] The one-time sharing code provided by the data
	// recipient. This field is only present when the authentication type is
	// DATABRICKS.
	SharingCode string `json:"sharing_code,omitempty"`
	// [Create:IGN,Update:IGN] recipient Tokens. This field is only present when
	// the authentication type is TOKEN.
	Tokens []RecipientTokenInfo `json:"tokens,omitempty"`
	// [Create:IGN,Update:IGN] Time at which the recipient was updated, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of recipient updater.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type RotateRecipientTokenResponseAuthenticationType string

type SchemaInfo struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Schema creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Full name of Schema, in form of
	// <catalog_name>.<schema_name>.
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Schema, relative to parent Catalog.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of Schema.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Schema.
	Privileges []SchemaInfoPrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create,Update:IGN] Time at which this Schema was created, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified Schema.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type SchemaInfoPrivilegesItem string

type SchemasAPI struct {
	// contains filtered or unexported fields
}

type SchemasService interface {

	// Create a schema
	//
	// Creates a new schema for catalog in the Metatastore. The caller must be a
	// Metastore admin, or have the CREATE privilege in the parentcatalog.
	Create(ctx context.Context, request CreateSchema) (*CreateSchemaResponse, error)

	// Delete a schema
	//
	// Deletes the specified schema from the parent catalog. The caller must be
	// the owner of the schema or an owner of the parent catalog.
	Delete(ctx context.Context, request DeleteSchemaRequest) error

	// Get a schema
	//
	// Gets the specified schema for a catalog in the Metastore. The caller must
	// be a Metastore admin, the owner of the schema, or a user that has the
	// USAGE privilege on the schema.
	Get(ctx context.Context, request GetSchemaRequest) (*GetSchemaResponse, error)

	// List schemas
	//
	// Gets an array of schemas for catalog in the Metastore. If the caller is
	// the Metastore admin or the owner of the parent catalog, all schemas for
	// the catalog will be retrieved. Otherwise, only schemas owned by the
	// caller (or for which the caller has the USAGE privilege) will be
	// retrieved.
	//
	// Use ListAll() to get all SchemaInfo instances
	List(ctx context.Context, request ListSchemasRequest) (*ListSchemasResponse, error)

	// Update a schema
	//
	// Updates a schema for a catalog. The caller must be the owner of the
	// schema. If the caller is a Metastore admin, only the __owner__ field can
	// be changed in the update. If the __name__ field must be updated, the
	// caller must be a Metastore admin or have the CREATE privilege on the
	// parent catalog.
	Update(ctx context.Context, request UpdateSchema) error
}

type ShareInfo struct {
	// [Create: OPT] comment when creating the share
	Comment string `json:"comment,omitempty"`
	// [Create:IGN] Time at which this Share was created, in epoch milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create:IGN] Username of Share creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create:REQ] Name of the Share.
	Name string `json:"name,omitempty"`
	// [Create: IGN] A list of shared data objects within the Share.
	Objects []SharedDataObject `json:"objects,omitempty"`
	// [Create:IGN,Update:OPT] Username of Share owner.
	Owner string `json:"owner,omitempty"`
	// [Create:IGN,Update:IGN] Time at which this Share was updated, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create:IGN,Update:IGN] Username of Share updater.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type SharePermissionsRequest struct {
	// Required. The name of the Recipient.
	Name string `json:"-" url:"-"`
}

type ShareToPrivilegeAssignment struct {
	// The privileges assigned to the principal.
	PrivilegeAssignments []PrivilegeAssignment `json:"privilege_assignments,omitempty"`
	// The share name.
	ShareName string `json:"share_name,omitempty"`
}

type SharedDataObject struct {
	// The time when this data object is added to the Share, in epoch
	// milliseconds. Output only field. [Update:IGN]
	AddedAt int64 `json:"added_at,omitempty"`
	// Username of the sharer. Output only field. [Update:IGN]
	AddedBy string `json:"added_by,omitempty"`
	// Whether to enable cdf or indicate if cdf is enabled on the shared object.
	// [Update: OPT]
	CdfEnabled bool `json:"cdf_enabled,omitempty"`
	// A user-provided comment when adding the data object to the share.
	// [Update:OPT]
	Comment string `json:"comment,omitempty"`
	// The type of the data object. Output only field. [Update:IGN]
	DataObjectType string `json:"data_object_type,omitempty"`
	// A fully qualified name that uniquely identifies a data object. For
	// example, a table's fully qualified name is in the format of
	// `<catalog>.<schema>.<table>`. [Update:REQ]
	Name string `json:"name,omitempty"`
	// Array of partitions for the shared data.
	Partitions []Partition `json:"partitions,omitempty"`
	// A user-provided new name for the data object within the share. If this
	// new name is not not provided, the object's original name will be used as
	// the `shared_as` name. The `shared_as` name must be unique within a Share.
	//
	// For tables, the new name must follow the format of `<schema>.<table>`.
	// [Update:OPT]
	SharedAs string `json:"shared_as,omitempty"`
	// The start version associated with the object. This allows data providers
	// to control the lowest object version that is accessible by clients. If
	// specified, clients can query snapshots or changes for versions >=
	// start_version. If not specified, clients can only query starting from the
	// version of the object at the time it was added to the share.
	//
	// NOTE: The start_version should be <= the \"current\" version of the
	// object. [Update: OPT]
	StartVersion int64 `json:"start_version,omitempty"`
	// One of: **ACTIVE**, **PERMISSION_DENIED**.
	Status SharedDataObjectStatus `json:"status,omitempty"`
}

type SharedDataObjectStatus string

type SharedDataObjectUpdate struct {
	// One of: **ADD**, **REMOVE**, **UPDATE**.
	Action SharedDataObjectUpdateAction `json:"action,omitempty"`
	// The data object that is being added, removed, or updated.
	DataObject *SharedDataObject `json:"data_object,omitempty"`
}

type SharedDataObjectUpdateAction string

type SharesAPI struct {
	// contains filtered or unexported fields
}

type SharesService interface {

	// Create a share
	//
	// Creates a new share for data objects. Data objects can be added at this
	// time or after creation with **update**. The caller must be a Metastore
	// admin or have the CREATE SHARE privilege on the Metastore.
	Create(ctx context.Context, request CreateShare) (*CreateShareResponse, error)

	// Delete a share
	//
	// Deletes a data object share from the Metastore. The caller must be an
	// owner of the share.
	Delete(ctx context.Context, request DeleteShareRequest) error

	// Get a share
	//
	// Gets a data object share from the Metastore. The caller must be a
	// Metastore admin or the owner of the share.
	Get(ctx context.Context, request GetShareRequest) (*GetShareResponse, error)

	// List shares
	//
	// Gets an array of data object shares from the Metastore. The caller must
	// be a Metastore admin or the owner of the share.
	//
	// Use ListAll() to get all ShareInfo instances
	List(ctx context.Context) (*ListSharesResponse, error)

	// Get permissions
	//
	// Gets the permissions for a data share from the Metastore. The caller must
	// be a Metastore admin or the owner of the share.
	SharePermissions(ctx context.Context, request SharePermissionsRequest) (*GetSharePermissionsResponse, error)

	// Update a share
	//
	// Updates the share with the changes and data objects in the request. The
	// caller must be the owner of the share or a Metastore admin.
	//
	// When the caller is a Metastore admin, only the __owner__ field can be
	// updated.
	//
	// In the case that the Share name is changed, **updateShare** requires that
	// the caller is both the share owner and a Metastore admin.
	//
	// For each table that is added through this method, the share owner must
	// also have SELECT privilege on the table. This privilege must be
	// maintained indefinitely for recipients to be able to access the table.
	// Typically, you should use a group as the share owner.
	//
	// Table removals through **update** do not require additional privileges.
	Update(ctx context.Context, request UpdateShare) error

	// Update permissions
	//
	// Updates the permissions for a data share in the Metastore. The caller
	// must be a Metastore admin or an owner of the share.
	//
	// For new recipient grants, the user must also be the owner of the
	// recipients. recipient revocations do not require additional privileges.
	UpdatePermissions(ctx context.Context, request UpdateSharePermissions) error
}

type StorageCredentialInfo struct {
	// The AWS IAM role configuration.
	AwsIamRole *AwsIamRole `json:"aws_iam_role,omitempty"`
	// The Azure service principal configuration.
	AzureServicePrincipal *AzureServicePrincipal `json:"azure_service_principal,omitempty"`
	// [Create,Update:OPT] Comment associated with the credential.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Credential was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of credential creator.
	CreatedBy string `json:"created_by,omitempty"`
	// The GCP service account key configuration.
	GcpServiceAccountKey *GcpServiceAccountKey `json:"gcp_service_account_key,omitempty"`
	// [Create:IGN] The unique identifier of the credential.
	Id string `json:"id,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ, Update:OPT] The credential name. The name MUST be unique
	// within the Metastore.
	Name string `json:"name,omitempty"`
	// [Create:IGN Update:OPT] Username of current owner of credential.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Time at which this credential was last modified, in
	// epoch milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the credential.
	UpdatedBy string `json:"updated_by,omitempty"`
}

type StorageCredentialsAPI struct {
	// contains filtered or unexported fields
}

type StorageCredentialsService interface {

	// Create credentials
	//
	// Creates a new storage credential. The request object is specific to the
	// cloud:
	//
	// * **AwsIamRole** for AWS credentials * **AzureServicePrincipal** for
	// Azure credentials * **GcpServiceAcountKey** for GCP credentials.
	//
	// The caller must be a Metastore admin and have the CREATE STORAGE
	// CREDENTIAL privilege on the Metastore.
	Create(ctx context.Context, request CreateStorageCredential) (*CreateStorageCredentialResponse, error)

	// Delete a credential
	//
	// Deletes a storage credential from the Metastore. The caller must be an
	// owner of the storage credential.
	Delete(ctx context.Context, request DeleteStorageCredentialRequest) error

	// Get a credential
	//
	// Gets a storage credential from the Metastore. The caller must be a
	// Metastore admin, the owner of the storage credential, or have a level of
	// privilege on the storage credential.
	Get(ctx context.Context, request GetStorageCredentialRequest) (*GetStorageCredentialResponse, error)

	// List credentials
	//
	// Gets an array of storage credentials (as StorageCredentialInfo objects).
	// The array is limited to only those storage credentials the caller has the
	// privilege level to access. If the caller is a Metastore admin, all
	// storage credentials will be retrieved.
	//
	// Use ListAll() to get all StorageCredentialInfo instances
	List(ctx context.Context) (*ListStorageCredentialsResponse, error)

	// Update a credential
	//
	// Updates a storage credential on the Metastore. The caller must be the
	// owner of the storage credential. If the caller is a Metastore admin, only
	// the __owner__ credential can be changed.
	Update(ctx context.Context, request UpdateStorageCredential) error
}

type StringKeyValuePair struct {
	// The key for the tuple.
	Key string `json:"key"`
	// The value for the tuple.
	Value string `json:"value"`
}

type TableInfo struct {
	// [Create:REQ Update:IGN] Name of parent Catalog.
	CatalogName string `json:"catalog_name,omitempty"`
	// This name ('columns') is what the client actually sees as the field name
	// in messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Columns []ColumnInfo `json:"columns,omitempty"`
	// [Create,Update:OPT] User-provided free-form text description.
	Comment string `json:"comment,omitempty"`
	// [Create,Update:IGN] Time at which this Table was created, in epoch
	// milliseconds.
	CreatedAt int64 `json:"created_at,omitempty"`
	// [Create,Update:IGN] Username of Table creator.
	CreatedBy string `json:"created_by,omitempty"`
	// [Create,Update:IGN] Unique ID of the data_access_configuration to use.
	DataAccessConfigurationId string `json:"data_access_configuration_id,omitempty"`
	// [Create:REQ Update:OPT] Data source format ("DELTA", "CSV", etc.).
	DataSourceFormat TableInfoDataSourceFormat `json:"data_source_format,omitempty"`
	// [Create,Update:IGN] Full name of Table, in form of
	// <catalog_name>.<schema_name>.<table_name>
	FullName string `json:"full_name,omitempty"`
	// [Create,Update:IGN] Unique identifier of parent Metastore.
	MetastoreId string `json:"metastore_id,omitempty"`
	// [Create:REQ Update:OPT] Name of Table, relative to parent Schema.
	Name string `json:"name,omitempty"`
	// [Create: IGN Update:OPT] Username of current owner of Table.
	Owner string `json:"owner,omitempty"`
	// [Create,Update:IGN] Privileges the user has on the Table.
	Privileges []TableInfoPrivilegesItem `json:"privileges,omitempty"`
	// This name ('properties') is what the client sees as the field name in
	// messages that include PropertiesKVPairs using 'json_inline' (e.g.,
	// TableInfo).
	Properties []StringKeyValuePair `json:"properties,omitempty"`
	// [Create:REQ Update:IGN] Name of parent Schema relative to its parent
	// Catalog.
	SchemaName string `json:"schema_name,omitempty"`
	// [Create,Update:OPT] List of schemes whose objects can be referenced
	// without qualification.
	SqlPath string `json:"sql_path,omitempty"`
	// [Create:OPT Update:IGN] Name of the storage credential this table used
	StorageCredentialName string `json:"storage_credential_name,omitempty"`
	// [Create:REQ Update:OPT] Storage root URL for table (for MANAGED, EXTERNAL
	// tables)
	StorageLocation string `json:"storage_location,omitempty"`
	// [Create:IGN Update:IGN] Name of Table, relative to parent Schema.
	TableId string `json:"table_id,omitempty"`
	// [Create:REQ Update:OPT] Table type ("MANAGED", "EXTERNAL", "VIEW").
	TableType TableInfoTableType `json:"table_type,omitempty"`
	// [Create,Update:IGN] Time at which this Table was last modified, in epoch
	// milliseconds.
	UpdatedAt int64 `json:"updated_at,omitempty"`
	// [Create,Update:IGN] Username of user who last modified the Table.
	UpdatedBy string `json:"updated_by,omitempty"`
	// [Create,Update:OPT] View definition SQL (when table_type == "VIEW")
	ViewDefinition string `json:"view_definition,omitempty"`
}

type TableInfoDataSourceFormat string

type TableInfoPrivilegesItem string

type TableInfoTableType string

type TableSummariesRequest struct {
	// Required. Name of parent catalog for tables of interest.
	CatalogName string `json:"-" url:"catalog_name,omitempty"`
	// Optional. Maximum number of tables to return (page length). Defaults to
	// 10000.
	MaxResults int `json:"-" url:"max_results,omitempty"`
	// Optional. Opaque token to send for the next page of results (pagination).
	PageToken string `json:"-" url:"page_token,omitempty"`
	// Optional. A sql LIKE pattern (% and _) for schema names. All schemas will
	// be returned if not set or empty.
	SchemaNamePattern string `json:"-" url:"schema_name_pattern,omitempty"`
	// Optional. A sql LIKE pattern (% and _) for table names. All tables will
	// be returned if not set or empty.
	TableNamePattern string `json:"-" url:"table_name_pattern,omitempty"`
}

type TableSummary struct {
	// The full name of the table.
	FullName string `json:"full_name,omitempty"`
	// One of: **UNKNOWN_TABLE_TYPE**, **MANAGED**, **EXTERNAL**, **VIEW**.
	TableType TableSummaryTableType `json:"table_type,omitempty"`
}

type TableSummaryTableType string

type TablesAPI struct {
	// contains filtered or unexported fields
}