BL_IAM_ASSUME_ROLE_ARN= Data Set Option

Specifies an Amazon Resource Name (ARN) that identifies an IAM role.

Valid in: DATA and PROC steps (when accessing data that is in an external data source)
Category: Data Access
Default: none
Requirement: To use this option, you must first specify BULKLOAD=YES or BULKUNLOAD=YES.
Interaction: If you specify both BL_IAM_ASSUME_ROLE_ARN= and BL_IAM_ASSUME_ROLE_NAME=, then the BL_IAM_ASSUME_ROLE_NAME= value is used.
Data source: Amazon Redshift, Spark
Note: Support for Amazon Redshift and Spark was added in SAS 9.4M9.
See: BL_IAM_ASSUME_ROLE_ARN= LIBNAME option
Example: BL_IAM_ASSUME_ROLE_ARN="arn:aws:iam::111122223333:role/eard"

Table of Contents

Syntax

BL_IAM_ASSUME_ROLE_ARN="value"

Required Argument

value

specifies an Amazon resource name (ARN) that identifies an IAM role. The associated IAM role enables you to get access credentials for S3 via the AssumeRole IAM operation.

Details

This option is used only when you are bulk loading data to AWS or bulk unloading data from AWS.

This option is used to access IAM role credentials in the S3 environment in AWS. If credentials are provided in more than one way, SAS/ACCESS retrieves values in the following order.

  1. BL_IAM_ASSUME_ROLE_ARN= data set option
  2. BL_IAM_ASSUME_ROLE_ARN= LIBNAME option
  3. AWS CLI configuration file in SAS
  4. EC2 instance in AWS

For example, if no value is set for the data set option but a value is set for the LIBNAME option, then SAS/ACCESS uses the LIBNAME option value. No further locations are checked.

For more information about S3 configuration, see PROC S3 Configuration in Base SAS Procedures Guide.

Spark: This option is supported for bulk loading to Databricks in AWS. For more information, see Bulk Loading and Unloading to Databricks in Azure.

Last updated: February 3, 2026