Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

D toc

d-excerpt

You can create connections to specific S3 buckets through the 

D s webapp
.  These connections to S3 enable workspace users to read data from specific S3 buckets. 


Info

NOTE: All S3 connections created through the

D s webapp
are read-only connections.

Simple Storage Service (S3) is an online data storage service provided by Amazon, which provides low-latency access through web services. For more information, see https://aws.amazon.com/s3/.

Prerequisites

Before you begin, please verify that your 

D s item
itemenvironment
rtrue
 meets the following requirements:

  • Deployment:

    D s platform
     is deployed in an EC2 instance on AWS.

  • Base storage layer: S3 must be set as the base storage layer.

  • Integration: Your  

    D s item
    iteminstance
     is connected to a running environment supported by your product edition.

  • Multiple region: Multiple S3 connections can be configured in different regions.

  • Verify that Enable S3 Connectivity has been enabled in the Workspace Settings Page. For more information, see Platform Configuration Methods.

  • Acquire the Access Key ID and Secret Key for the S3 bucket or buckets to which you are connecting. For more information on acquiring your key/secret combination, contact your S3 administrator.

Permissions

Access to S3 requires:

  • S3 must be set as the base storage layer.
  • Each user is able to access S3.

To browse multiple buckets through a single S3 connection, additional permissions are required. See below.

Limitations

  • Authentication using IAM roles is not supported.
  • Automatic region detection in the create and edit connection is not supported.

Create Connection

You can create additional S3 connections by the following method:

Create through application

You can create a S3 connection through the application.

Steps:

  1. Login to the application.
  2. In the left navigation bar, click the Connections icon.
  3. In the Create Connection page, click the External Amazon S3 card.

  4. Specify the connection properties:

    PropertyDescription
    DefaultBucket

    (Optional) The default S3 bucket to which to connect. When the connection is first accessed for browsing, the contents of this bucket are displayed.

    If this value is not provided, then the list of available buckets based on the key/secret combination is displayed when browsing through the connection.

    Info

    NOTE: To see the list of available buckets, the connecting user must have the getBucketList permission. If that permission is not present and no default bucket is listed, then the user cannot browse S3.

    Access Key ID

    Access Key ID for the S3 connection.

    Secret Key

    Secret Key for the S3 connection.


    For more information on the other options, see Create Connection Window.

  5. Click Save

Create via API

For more information on the vendor and type information to use, see Connection Types.

For more information, see 

D s api refdoclink
operation/createConnection

Java VFS Service

The Java VFS Service has been modified to handle an optional connection ID, enabling S3 URLs with connection ID and credentials. The other connection details are fetched through the 

D s webapp
 to create the required URL and configuration.

Code Block
// sample URI
s3://bucket-name/path/to/object?connectionId=136


// sample java-vfs-service CURL request with s3
curl -H 'x-trifacta-person-workspace-id: 1' -X GET 'http://localhost:41917/vfsList?uri=s3://bucket-name/path/to/object?connectionId=136'

Use

For more information, see S3 Browser.

For more information about interacting with data on S3, see Using S3.

Testing

  1. Import a dataset from S3.
  2. Add it to a flow and run a job.

For more information, see Verify Operations.