client.SDAClient

client.SDAClient(
    base_url='https://sdmdataaccess.sc.egov.usda.gov',
    timeout=60.0,
    max_retries=3,
    retry_delay=1.0,
    config=None,
)

Async HTTP client for Soil Data Access web service.

Methods

Name	Description
close	Close the HTTP client and clean up resources.
connect	Test connection to SDA service.
execute	Execute a query against SDA.
execute_many	Execute multiple queries concurrently.
execute_sql	Execute a raw SQL query against SDA.

close

client.SDAClient.close()

Close the HTTP client and clean up resources.

connect

client.SDAClient.connect()

Test connection to SDA service.

Returns: True if connection successful

Raises: SDAConnectionError: If connection fails

execute

client.SDAClient.execute(query)

Execute a query against SDA.

Args: query: Query object or raw SQL string to execute

Returns: SDAResponse containing query results

Raises: SDAQueryError: If query execution fails SDAMaintenanceError: If service is under maintenance SDATimeoutError: If request times out SDAConnectionError: If connection fails

execute_many

client.SDAClient.execute_many(queries)

Execute multiple queries concurrently.

Args: queries: List of query objects to execute

Returns: List of SDAResponse objects in same order as input queries

execute_sql

client.SDAClient.execute_sql(sql)

Execute a raw SQL query against SDA.

Args: sql: The raw SQL query string.

Returns: SDAResponse containing query results

Raises: SDAQueryError: If query execution fails SDAMaintenanceError: If service is under maintenance SDATimeoutError: If request times out SDAConnectionError: If connection fails