Glue / Client / get_catalog

get_catalog#

Glue.Client.get_catalog(**kwargs)#

The name of the Catalog to retrieve. This should be all lowercase.

See also: AWS API Documentation

Request Syntax

response = client.get_catalog(
    CatalogId='string'
)
Parameters:

CatalogId (string) –

[REQUIRED]

The ID of the parent catalog in which the catalog resides. If none is provided, the Amazon Web Services Account Number is used by default.

Return type:

dict

Returns:

Response Syntax

{
    'Catalog': {
        'CatalogId': 'string',
        'Name': 'string',
        'ResourceArn': 'string',
        'Description': 'string',
        'Parameters': {
            'string': 'string'
        },
        'CreateTime': datetime(2015, 1, 1),
        'UpdateTime': datetime(2015, 1, 1),
        'TargetRedshiftCatalog': {
            'CatalogArn': 'string'
        },
        'FederatedCatalog': {
            'Identifier': 'string',
            'ConnectionName': 'string'
        },
        'CatalogProperties': {
            'DataLakeAccessProperties': {
                'DataLakeAccess': True|False,
                'DataTransferRole': 'string',
                'KmsKey': 'string',
                'ManagedWorkgroupName': 'string',
                'ManagedWorkgroupStatus': 'string',
                'RedshiftDatabaseName': 'string',
                'StatusMessage': 'string',
                'CatalogType': 'string'
            },
            'CustomProperties': {
                'string': 'string'
            }
        },
        'CreateTableDefaultPermissions': [
            {
                'Principal': {
                    'DataLakePrincipalIdentifier': 'string'
                },
                'Permissions': [
                    'ALL'|'SELECT'|'ALTER'|'DROP'|'DELETE'|'INSERT'|'CREATE_DATABASE'|'CREATE_TABLE'|'DATA_LOCATION_ACCESS',
                ]
            },
        ],
        'CreateDatabaseDefaultPermissions': [
            {
                'Principal': {
                    'DataLakePrincipalIdentifier': 'string'
                },
                'Permissions': [
                    'ALL'|'SELECT'|'ALTER'|'DROP'|'DELETE'|'INSERT'|'CREATE_DATABASE'|'CREATE_TABLE'|'DATA_LOCATION_ACCESS',
                ]
            },
        ]
    }
}

Response Structure

  • (dict) –

    • Catalog (dict) –

      A Catalog object. The definition of the specified catalog in the Glue Data Catalog.

      • CatalogId (string) –

        The ID of the catalog. To grant access to the default catalog, this field should not be provided.

      • Name (string) –

        The name of the catalog. Cannot be the same as the account ID.

      • ResourceArn (string) –

        The Amazon Resource Name (ARN) assigned to the catalog resource.

      • Description (string) –

        Description string, not more than 2048 bytes long, matching the URI address multi-line string pattern. A description of the catalog.

      • Parameters (dict) –

        A map array of key-value pairs that define parameters and properties of the catalog.

        • (string) –

          • (string) –

      • CreateTime (datetime) –

        The time at which the catalog was created.

      • UpdateTime (datetime) –

        The time at which the catalog was last updated.

      • TargetRedshiftCatalog (dict) –

        A TargetRedshiftCatalog object that describes a target catalog for database resource linking.

        • CatalogArn (string) –

          The Amazon Resource Name (ARN) of the catalog resource.

      • FederatedCatalog (dict) –

        A FederatedCatalog object that points to an entity outside the Glue Data Catalog.

        • Identifier (string) –

          A unique identifier for the federated catalog.

        • ConnectionName (string) –

          The name of the connection to an external data source, for example a Redshift-federated catalog.

      • CatalogProperties (dict) –

        A CatalogProperties object that specifies data lake access properties and other custom properties.

        • DataLakeAccessProperties (dict) –

          A DataLakeAccessProperties object with input properties to configure data lake access for your catalog resource in the Glue Data Catalog.

          • DataLakeAccess (boolean) –

            Turns on or off data lake access for Apache Spark applications that access Amazon Redshift databases in the Data Catalog.

          • DataTransferRole (string) –

            A role that will be assumed by Glue for transferring data into/out of the staging bucket during a query.

          • KmsKey (string) –

            An encryption key that will be used for the staging bucket that will be created along with the catalog.

          • ManagedWorkgroupName (string) –

            The managed Redshift Serverless compute name that is created for your catalog resource.

          • ManagedWorkgroupStatus (string) –

            The managed Redshift Serverless compute status.

          • RedshiftDatabaseName (string) –

            The default Redshift database resource name in the managed compute.

          • StatusMessage (string) –

            A message that gives more detailed information about the managed workgroup status.

          • CatalogType (string) –

            Specifies a federated catalog type for the native catalog resource. The currently supported type is aws:redshift.

        • CustomProperties (dict) –

          Additional key-value properties for the catalog, such as column statistics optimizations.

          • (string) –

            • (string) –

      • CreateTableDefaultPermissions (list) –

        An array of PrincipalPermissions objects. Creates a set of default permissions on the table(s) for principals. Used by Amazon Web Services Lake Formation. Not used in the normal course of Glue operations.

        • (dict) –

          Permissions granted to a principal.

          • Principal (dict) –

            The principal who is granted permissions.

            • DataLakePrincipalIdentifier (string) –

              An identifier for the Lake Formation principal.

          • Permissions (list) –

            The permissions that are granted to the principal.

            • (string) –

      • CreateDatabaseDefaultPermissions (list) –

        An array of PrincipalPermissions objects. Creates a set of default permissions on the database(s) for principals. Used by Amazon Web Services Lake Formation. Not used in the normal course of Glue operations.

        • (dict) –

          Permissions granted to a principal.

          • Principal (dict) –

            The principal who is granted permissions.

            • DataLakePrincipalIdentifier (string) –

              An identifier for the Lake Formation principal.

          • Permissions (list) –

            The permissions that are granted to the principal.

            • (string) –

Exceptions