BL_IAM_ASSUME_ROLE_ARN= LIBNAME Statement Option

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

Valid in: LIBNAME statement that connects to an external data source
Category: Data Access
Default: none
Interaction: This option is used only when you also specify BULKLOAD=YES or BULKUNLOAD=YES.
Data source: Amazon Redshift, Spark
Note: Support for this option was added in SAS 9.4M9.
See: BL_IAM_ASSUME_ROLE_ARN= data set option
Example: BL_IAM_ASSUME_ROLE_ARN="arn:aws:iam::111122223333:role/eard"

Table of Contents

Syntax

BL_IAM_ASSUME_ROLE_ARN="ARN-value"

Required Argument

ARN-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