Street Names

This collection of SQL artefacts can be used to randomly generate street name values, either singularly or in batches of up to 10000 values.

Reference data.

All procedures and functions described below generate values based on the values in [Reference].[street]. It is recommended that this table be populated with prerandomised data.

This table can be populated by executing the procedure [Reference].[usp_Populate_street]. Values can be added to, or removed from this table, but the following rules must be enforced:

• Values for streetSK must be continuous and have no gaps.
• [SystemControl].[ReferenceControl] must be maintained so that the value for MaxReferenceSK accurately reflects the number of records in [Reference].[street].

The table can be repopluated, resolving any breaches of the above rules, by executing procedure [Reference].[usp_Maintain_street].

Procedures and functions

[SingleValue].[ufn_Get_street]

This function will return a random street name value. As a function; this method can be used to easily assign a value to an variable, or to update a field on a table.

Example usages:

Declare	@Street varchar(50)
Select	@Street = [SingleValue].[ufn_Get_Street]()
Select  @Street

[SingleValue].[usp_Get_street]

This procedure will return a random street name value. The generated value is returned via the output parameter @street, and can be captured in a variable, or passed back to a calling application.

Example usages:

Declare @Street varchar(50)
exec	SingleValue.usp_Get_Street @Street out
Select	@Street

[Fountain].[usp_Get_street]

This procedure will return the next available street name value. This method, whilst not strictly random, ensures that values are evenly allocated over time. The generated value is returned via the output parameter @street, and can be captured in a variable, or passed back to a calling application.

Example usages:

Declare @Street varchar(50)
exec	Fountain.usp_Get_Street @Street out
Select	@Street

[BulkValue].[usp_Get_street]

This procedure will return up to 10000 random street values. This procedure has the following input parameter:

Parameter	Data Type	Default Value
@QuantityRequired	smallint	None

A recordset with the following structure is returned:

Field Name	Data Type
street	varchar(50)

This method is useful for inserting bulk data directly in to a table, or as an ETL source.

Example Usage:

exec	[BulkValue].[usp_Get_Street] 100

[BulkFountain].[usp_Get_street]

This procedure will return up to 10000 street values. This method, whilst not strictly random, ensures that values are allocated evenly over time. This procedure has the following input parameter:

Parameter	Data Type	Default Value
@QuantityRequired	smallint	None

A recordset with the following structure is returned:

Field Name	Data Type
street	varchar(50)

This method is useful for inserting bulk data directly in to a table, or as an ETL source.

Example Usage:

exec BulkFountain.[usp_Get_Street] 1000