Sharing S3 Tables catalog objects - Amazon Glue
Sharing within the same account using resource links
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Sharing S3 Tables catalog objects

When using IAM access control, you can share S3 Tables catalog objects with other users using Amazon Glue resource links for same-account sharing. For cross-account sharing, you can share S3 table buckets with another Amazon account and the IAM role or user in the recipient account can create a Amazon Glue catalog object using the shared table bucket.

Resource links allow you to create references to Amazon Glue databases and tables in the s3tablescatalog that appear in your Amazon Glue default catalog. This is useful for organizing data access or creating logical groupings of tables.

  1. Open the Amazon Glue console at https://console.aws.amazon.com/glue/.

  2. In the navigation pane, choose Catalogs.

  3. In the Catalog list, select s3tablescatalog.

  4. Select the table you want to share from the s3tablescatalog.

  5. Choose Actions, then choose Create resource link.

  6. For Resource link name, enter a name for the resource link.

  7. For Target database, select the database where you want to create the resource link.

  8. (Optional) For Description, enter a description.

  9. Choose Create.

The resource link appears in the target database and points to the original table in s3tablescatalog.

Create a database resource link:

aws glue create-database \
  --database-name "my-database-resource-link" \
  --database-input '{
    "Name": "sales_data_link",
    "TargetDatabase": {
      "CatalogId": "account-id:s3tablescatalog/analytics-bucket",
      "DatabaseName": "sales"
    }
  }'

Create a table resource link:

aws glue create-table \
  --table-name "my-table-resource-link" \
  --table-input '{
    "Name": "sales_data_link",
    "TargetTable": {
      "CatalogId": "account-id:s3tablescatalog/analytics-bucket",
      "DatabaseName": "sales",
      "Name": "transactions"
    }
  }'