View a markdown version of this page

Sharing S3 Tables catalog objects - AWS Glue
Sharing within the same account using resource links

Sharing S3 Tables catalog objects

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

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

  1. Open the AWS 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"
    }
  }'